Assign-card-to-customer: Asignar tarjeta a un cliente

Descripción

Con este endpoint, podrás asignar el token de una tarjeta a un cliente ya registrado. El token de la tarjeta será el creado por el proceso de compra del usuario invitado.


Method: post
URL: https://{enviroment-domain}/api/v1/Card/assign-card-to-customer

Agregar encabezados de autenticación

Ejemplo:

Body

{
  "merchantId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "customerId": "IdUser",
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Descripción de campos

CampoDescripción
MerchantIdIdentificador único del comerciante en la pasarela de pago, es asignado al momento de crear la cuenta.
CustomerIdIdentificador único del cliente. Este identificador lo asigna el propio comercio, es de tipo alfanumérico y no mayor a 100 caracteres.
TokenToken asignado a la tarjeta, en el proceso de pago con usuario invitado

Ejemplo de respuesta exitosa

Http code 200

{
  "isSuccess": true,
  "payload": {
    "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

Ejemplos de respuesta con error

Http code 404

Tarjeta no existente

{
    "isSuccess": false,
    "errors": [
        {
            "key": "ResourceNotFoundException",
            "value": [
                "Card not found: 3fa85f64-5717-4562-b3fc-2c963f66afa6 3fa85f64-5717-4562-b3fc-2c963f66afa6"
            ]
        }
    ]
}


Descripción de campos

CampoDescripción
IsSuccessIndica si la petición se pudo completar satisfactoriamente.
PayloadRespuesta solicitada a nuestro sistema.
TokenToken asignado a la tarjeta.
ErrorsUna lista de errores que ocurrieron en la petición.
KeyLlave del error
ValueBreve descripción del error.


📘

CONSIDERACIONES IMPORTANTES

  • Los campos MerchantId, CustomerId y Token son obligatorios.
  • La tarjeta que puede ser asignada será solamente la creada por el proceso de pago con usuario invitado.
  • Una tarjeta creada por el proceso de pago con usuario invitado, la almacenaremos sólo 1hr a partir de su creación. Sólo durante este tiempo se podrá asignar esta tarjeta a un cliente.