Tarjetas
Convierte un token en una tarjeta (card) y podrás realizar cargos posteriores con mucha facilidad.
La tarjeta es un servicio que te permite guardar la información de las tarjetas de crédito o débito de tus clientes para luego realizarles cargos one click o recurrentes (cargos posteriores sin que tus clientes vuelvan a ingresar los datos de su tarjeta).
Las tarjetas pueden ser creadas vía API de tarjetas.
Creando una tarjeta
Una tarjeta se crea a partir de la información de la tarjeta ingresada por el cliente. Previamente debes haber creado un cliente y un token, incluyendo los siguientes datos:
{
"customer_id": "cus_test_xxxxxxxxxxxxxxxx",
"token_id": "tkn_live_xxxxxxxxxxx"
}Anatomía de una tarjeta
El API de tarjeta nos retorna un objeto card con un id único (crd_live_xxxxxxxxxxx), con más información de la tarjeta como banco emisor, marca y id del cliente asociado:
{
"object": "card",
"id": "crd_live_xxxxxxxxxxx",
"date": 1487044833972,
"customer_id": "cus_test_xxxxxxxxxxxxxxxx",
"token": {
"object": "token",
"id": "tkn_live_xxxxxxxxxxx",
"type": "card",
"creation_date": 1487044809000,
"card_number": "411111******1111",
"last_four": "1111",
"active": true,
"iin": {
"object": "iin",
"bin": "411111",
"card_brand": "Visa",
"card_type": "credit",
"card_category": "Clásica",
"issuer": {
"name": "JPMORGAN CHASE BANK, N.A.",
"country": "United States",
"country_code": "PE",
"website": null,
"phone_number": null
},
"installments_allowed": [2, 4, 6, 8, 10, 12]
},
"client": {
"ip": "190.235.231.153",
"ip_country": "Perú",
"ip_country_code": "PE",
"browser": null,
"device_fingerprint": null,
"device_type": null
}
},
"metadata": {}
}Tarjeta API
Revisa nuestra API de tarjetas para obtener más información:
| Acción | Url |
|---|---|
| Crear un tarjeta | https://apidocs.culqi.com/#tag/Tarjetas/operation/crear-tarjeta |
| Consultar un tarjeta | https://apidocs.culqi.com/#tag/Tarjetas/operation/consultar-tarjeta |
| Listar tarjetas | https://apidocs.culqi.com/#tag/Tarjetas/operation/listar-tarjeta |
| Actualizar un tarjeta | https://apidocs.culqi.com/#tag/Tarjetas/operation/actualizar-tarjeta |
| Eliminar un tarjeta | https://apidocs.culqi.com/#tag/Tarjetas/operation/eliminar-tarjeta |