Tarjetas
Cards

Guardar tarjeta crédito/débito

Changed on

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

Request

  • Base URL
    https://api.paylands.com/v1/sandbox
  • URL
    https://api.paylands.com/v1/sandbox/payment-method/card
  • Auth
    none required

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

OK

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)

Changes

    • info

      added the optional property // to the response with the status

    • info

      removed the PAYLATER enum value from the // response property for the response status