The Card Information endpoints provide lookup tools for Card Present flows in Chile: retrieve card type and deferred availability from a BIN, and fetch installment options (Cuotas Comercio and Cuotas Emisor) for a specific card.
Endpoints at a glance#
| Endpoint | Purpose |
|---|
POST /pos/v1/bin | BIN lookup — returns card type and deferred availability |
GET /deferred/v2/bin/{bin} | Deferred options v2 — installment types and months for a BIN |
GET /card/v1/deferred/{bin} | Deferred options v1 — available installment months for a BIN |
BIN lookup#
Call POST /pos/v1/bin with the card BIN (first 6–8 digits) to determine whether the card supports installments before proceeding.{
"bin": "43810200",
"pos_details": {
"terminal_id": "PB04209860189",
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.28"
}
}
{
"card_type": "credit",
"country": "CHL",
"deferred": true
}
| Response field | Description |
|---|
card_type | "credit", "debit", or "prepaid". |
country | ISO 3166-1 alpha-3 of the card-issuing country. |
deferred | true if the card supports installment payments. |
Deferred options#
Use these endpoints to retrieve valid installment configurations for a BIN before creating a deferred charge. Always query deferred options first — available months and credit types depend on the specific card BIN.Deferred options (Cuotas) are only available for credit cards.
v2 — GET /deferred/v2/bin/{bin}#
Returns card metadata together with installment options.GET /deferred/v2/bin/43810200
Public-Merchant-Id: <your-public-key>
| Field | Description |
|---|
bank | Issuing bank name. |
brand | Card network (e.g., "visa", "mastercard"). |
cardType | "credit", "debit", or "prepaid". |
country | Card-issuing country. |
v1 — GET /card/v1/deferred/{bin}#
Returns the available deferred types and installment months.GET /card/v1/deferred/43810200
Public-Merchant-Id: <your-public-key>
[
{
"months": ["2", "3", "6", "9", "12"],
"monthsOfGrace": [],
"type": "03"
},
{
"months": ["3", "6", "9", "12", "18", "24", "36"],
"monthsOfGrace": [],
"type": "all"
}
]
type value | Meaning |
|---|
"03" | Cuotas Comercio — Merchant Installments. Use credit_type: "03" in the charge request. |
"all" | Cuotas Emisor — Issuer Installments. Omit credit_type in the charge request. |
Use the type and months values from this response to construct the deferred object in the charge request.
Authentication#
| Endpoint | Header |
|---|
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> |
Environments#
https://api.kushkipagos.com/
Available Endpoints#
BIN Lookup
Query a card BIN to retrieve card type and Cuotas availability.
Deferred Options v2
Retrieve BIN metadata and available Cuotas Comercio / Cuotas Emisor configurations (v2).
Deferred Options v1
Retrieve available installment months for a BIN (v1).
Got a suggestion on this documentation? Contact us.
