La tarjeta ya inscrita: bin, marca, expiración y el token con el que se cobra.
Esta página describe la tarjeta como medio de pago inscrito: lo que devuelven los endpoints de inscripción y lo que verás anidado en un PaymentMethod de tipo card.
Nunca contiene el número completo de la tarjeta ni su CVV: para cobrar se usa el token.
No confundir con la tarjeta de una transacciónLa respuesta de Crear una Transaction con medio de pago Card trae otro objeto
card, dentro detransaction_details.payment_instrument: describe la tarjeta con la que se cobró esa transacción, y usa otros nombres de campo (country,exp_month,exp_year,issuer) más el detalle propio del cobro (installments_number,status). Son dos vistas distintas, no la misma con nombres cambiados.
Atributos
institution_country string
El país del banco al que pertenece la tarjeta.
bank_id string
El identificador del banco al que pertenece la tarjeta. Puedes consultar el listado de bancos con sus respectivos identificadores acá.
bank_name string
El nombre del banco al que pertenece la tarjeta.
additional_data nullable dictionary
Metadata adicional de la tarjeta.
bin string
El bin de la tarjeta. Corresponde a los primeros 6 dígitos del número de la tarjeta.
card_type string
El tipo de tarjeta. Puede tomar los valores debit (débito), credit (crédito) o prepago (prepaid).
card_brand string
La marca de la tarjeta —VISA, MASTERCARD, AMEX…—, tal como la reporta el registro de BINes. No es un enum cerrado.
expiration_month string
El mes de expiración de la tarjeta en formato MM (por ejemplo, si la tarjeta vence en enero este campo toma el valor 01).
expiration_year string
El año de expiración de la tarjeta en formato AAAA.
card_holder string
El nombre de la persona a la que pertenece la tarjeta.
last_digits string
Los últimos 4 dígitos del número de la tarjeta.
token string
Identificador único con el que se puede mandar a cobrar la tarjeta.
three_d_secure boolean
Si la tarjeta fue inscrita con una validación 3DS o no.
Ejemplo
{
"card": {
"institution_country": "MX",
"bank_id": "40036",
"bank_name": "mx_inbursa",
"additional_data": null,
"bin": "424242",
"card_type": "debit",
"card_brand": "VISA",
"expiration_month": "02",
"expiration_year": "2030",
"card_holder": "jon doe",
"last_digits": "4242",
"token": "example_token",
"three_d_secure": false
}
}