TRtrytoku
Tarjetas

Guardar una tarjeta como PaymentInstrument

Guarda una tarjeta en la bóveda PCI de Toku y crea el PaymentInstrument que la representa. No la cobra ni la inscribe como medio de pago.

Los parámetros obligatorios son card_information, con al menos el PAN de la tarjeta, e id_customer, el Customer dueño del PaymentInstrument. La fecha de expiración, el titular y el CVV de la tarjeta son opcionales.

Responde 201 con el identificador del PaymentInstrument y 422 cuando falta un dato obligatorio o un campo no es válido.

post/mx/cards/instruments

Request

  • Base URL
    https://secure.api.trytoku.com
  • URL
    https://secure.api.trytoku.com/mx/cards/instruments
  • Auth
    API key in header x-api-key

Headers

x-org-idstring required

El identificador de tu organización. Toku lo exige en toda llamada a la PCI Compliant API.

Request body

id_customerstring required

Identificador del Customer dueño del PaymentInstrument.

Example request

{
  "card_information": {
    "full_name": "Jon Doe",
    "month": "02",
    "number": "4242424242424242",
    "verification_value": "123",
    "year": "2030"
  },
  "id_customer": "cus_2VpRsTjjdqkc2WfgBsPtzYxuOXX2i"
}

Response

PaymentInstrument creado.

payment_instrument_idstring required

Identificador del PaymentInstrument que representa la tarjeta guardada.

Example response

{
  "payment_instrument_id": "pin_Qm4ACZx0QjE84qKm8fffLq1wGjwgF"
}

Changes

No recorded changes to this operation across all 1 revision of this API.