latestOpenAPI 3.0.02026-08-1411579732.4 KB

6bf9c0ba354b

Tarjetas

Cards

Guardar tarjeta crédito/débito

Endpoint utilizado para almacenar una tarjeta de crédito, que se podrá utilizar para realizar un pago por WebService. La tarjeta será asociada al usuario indicado en el parámetro customer_ext_id.

Los campos validate, service y source_holder_verification solo deben enviarse cuando se desee realizar comprobaciones adicionales contra el servicio de pago durante el proceso de tokenización:

validate permite validar la tarjeta contra el servicio para comprobar si existe o si dispone de fondos en el momento de la validación.
source_holder_verification permite verificar que el titular indicado coincide con el titular real del medio de pago (SHV).

Cuando se utilice cualquiera de estas funcionalidades, será obligatorio enviar el campo service.

Nota: Es posible que una tarjeta no pueda ser tokenizada si se encuentra bajo sospecha de fraude. En esos casos, el servicio devolverá una respuesta de error con código 400.

post/payment-method/card

Parameters

#/paths/~1/get/parameters/0 — unresolved $ref

Request body

signatureSignature required— unresolved $ref

card_holderHolder required— unresolved $ref

card_panCardPan required— unresolved $ref

card_expiry_monthExpireMonth required— unresolved $ref

card_expiry_yearExpireYear required— unresolved $ref

customer_ext_idExternalId required— unresolved $ref

additionalAdditional — unresolved $ref

url_postUrlPost — unresolved $ref

validateboolean nullable

Sólo necesario si se quiere validar la tarjeta. Si se envía, el campo service es obligatorio, y el campo card_cvv puede enviarse para validar también el CVV.

serviceServiceUuid — unresolved $ref

card_cvvCardCvv — unresolved $ref

Example request

{
  "signature": "121149a0ba5361191d740fa898784a8b",
  "card_holder": "John Doe",
  "card_pan": "4111111111111111",
  "card_expiry_month": "12",
  "card_expiry_year": "19",
  "customer_ext_id": "user42",
  "additional": "card12345",
  "url_post": "https://my.website.com/process",
  "validate": false,
  "service": "60A1F4C0-CC58-47A9-A0B9-868F9EF29045",
  "card_cvv": "123"
}

Response

messagestring required

Nombre del código HTTP de respuesta.

codenumber required

Código de respuesta.

current_timestring required

Fecha y hora de la petición.

SourceSource — unresolved $ref