Descripción

Con este endpoint, podrás obtener el ID único para dar de alta una tarjeta.

Method: post
URL: https://{enviroment-domain}/api/v1/begin-transaction-create-card
Encabezados HTTP: Content-Type: application/json
Agregar encabezados de autenticación

Ejemplo:

Body

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

Descripción de campos

Campo	Descripción
`MerchantId`	Identificador único del comerciante en la pasarela de pago, es asignado al momento de crear la cuenta.
`CustomerId`	Identificador único del cliente. Este identificador lo asigna el propio comercio, es de tipo alfanumérico y no mayor a 100 caracteres.

Ejemplo de respuesta exitosa

Http code 200

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

Ejemplos de respuesta con error

Http code 404

Usuario no existente

{
    "isSuccess": false,
    "errors": [
        {
            "key": "ResourceNotFoundException",
            "value": [
                "User does not exist: 3fa85f64-5717-4562-b3fc-2c963f66afa6 IdUser"
            ]
        }
    ]
}

Descripción de campos

Campo	Descripción
`IsSuccess`	Indica si la petición se pudo completar satisfactoriamente.
`Payload`	Respuesta solicitada a nuestro sistema.
`Id`	Id único para la operación de alta de nueva tarjeta.
`Errors`	Una lista de errores que ocurrieron en la petición.
`Key`	Llave del error
`Value`	Breve descripción del error.

📘
CONSIDERACIONES IMPORTANTES

Los campos MerchantId y CustomerId son obligatorios.

El Id regresado sólo podrá ser usado para la operación de alta de nueva tarjeta.

El Id no podrá ser utilizado más de una vez.

El Id es único y tiene una duración de 1 hr a partir de su creación.

El límite de tarjetas para guardar por usuario estará sujeto a límites específicos.