Card information - Kushki Developer Portal

Los endpoints de Card Information te dan herramientas de consulta para los flujos presenciales en Chile: obtener el tipo de tarjeta y la disponibilidad de diferido a partir de un BIN, y consultar las opciones de diferido (Cuotas Comercio y Cuotas Emisor) de una tarjeta específica.

Resumen de endpoints

Endpoint	Propósito
`POST /pos/v1/bin`	Consulta de BIN — devuelve el tipo de tarjeta y la disponibilidad de diferido
`GET /deferred/v2/bin/{bin}`	Opciones de diferido v2 — tipos de diferido y meses para un BIN
`GET /card/v1/deferred/{bin}`	Opciones de diferido v1 — meses de diferido disponibles para un BIN

Consulta de BIN

Llama a POST /pos/v1/bin con el BIN de la tarjeta (primeros 6–8 dígitos) para saber si la tarjeta admite diferido antes de continuar.

Solicitud:

{
  "bin": "43810200",
  "pos_details": {
    "terminal_id": "PB04209860189",
    "brand": "SUNMI",
    "model": "P2-EU",
    "version": "Kushki SunmiV1.1.28"
  }
}

Respuesta:

{
  "card_type": "credit",
  "country": "CHL",
  "deferred": true
}

Campo de respuesta	Descripción
`card_type`	`"credit"`, `"debit"` o `"prepaid"`.
`country`	ISO 3166-1 alpha-3 del país emisor de la tarjeta.
`deferred`	`true` si la tarjeta admite diferido.

Opciones de diferido

Usa estos endpoints para obtener las configuraciones de diferido válidas de un BIN antes de crear un cargo diferido. Consulta siempre primero las opciones de diferido: los meses y los tipos de crédito disponibles dependen del BIN específico de la tarjeta.

INFO

Las opciones de diferido (Cuotas) solo están disponibles para tarjetas de crédito.

v2 — `GET /deferred/v2/bin/{bin}`

Devuelve los metadatos de la tarjeta junto con las opciones de diferido.

GET /deferred/v2/bin/43810200
Public-Merchant-Id: <your-public-key>

Campos de respuesta:

Campo	Descripción
`bank`	Nombre del banco emisor.
`brand`	Marca de la tarjeta (por ejemplo, `"visa"`, `"mastercard"`).
`cardType`	`"credit"`, `"debit"` o `"prepaid"`.
`country`	País emisor de la tarjeta.

v1 — `GET /card/v1/deferred/{bin}`

Devuelve los tipos de diferido y los meses de diferido disponibles.

GET /card/v1/deferred/43810200
Public-Merchant-Id: <your-public-key>

Ejemplo de respuesta:

[
  {
    "months": ["2", "3", "6", "9", "12"],
    "monthsOfGrace": [],
    "type": "03"
  },
  {
    "months": ["3", "6", "9", "12", "18", "24", "36"],
    "monthsOfGrace": [],
    "type": "all"
  }
]

Valor de `type`	Significado
`"03"`	Cuotas Comercio — diferido del comercio. Usa `credit_type: "03"` en el request de cargo.
`"all"`	Cuotas Emisor — diferido del emisor. Omite `credit_type` en el request de cargo.

Usa los valores de type y months de esta respuesta para construir el objeto deferred en el request de cargo.

Autenticación

Endpoint	Cabecera
`POST /pos/v1/bin`	`Private-Credential-Id: <your-private-credential>`
`GET /deferred/v2/bin/{bin}`	`Public-Merchant-Id: <your-public-key>`
`GET /card/v1/deferred/{bin}`	`Public-Merchant-Id: <your-public-key>`

Entornos

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Consulta de BIN

Consulta el BIN de una tarjeta para obtener el tipo de tarjeta y la disponibilidad de Cuotas.

Opciones de diferido v2

Obtén los metadatos del BIN y las configuraciones de Cuotas Comercio / Cuotas Emisor disponibles (v2).

Opciones de diferido v1

Obtén los meses de diferido disponibles para un BIN (v1).

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Información de la tarjeta

Resumen de endpoints#

Consulta de BIN#

Opciones de diferido#

v2 — GET /deferred/v2/bin/{bin}#

v1 — GET /card/v1/deferred/{bin}#

Autenticación#

Entornos#

Endpoints disponibles#

Resumen de endpoints

Consulta de BIN

Opciones de diferido

v2 — `GET /deferred/v2/bin/{bin}`

v1 — `GET /card/v1/deferred/{bin}`

Autenticación

Entornos

Endpoints disponibles