Recibe un pago C2P

C2P es un flujo de dos pasos para el tenant: crea una intención y luego ejecútala con el token del cliente.

Ciclo de vida de dos pasos

Solicita una intención
Envía el monto, la identidad del cliente, el teléfono y el código del banco a POST /v1/payments/c2p/request.
Obtén el token y ejecuta el pago
Solicita al cliente el token de 6 a 8 dígitos emitido por su banco y luego envíalo junto con los mismos datos del pago y el intentId devuelto a POST /v1/payments/c2p. El gateway no se comunica con el cliente.

1. Solicita una intención

curlbash

curl --request POST "${API_URL}/v1/payments/c2p/request" \
  --header "content-type: application/json" \
  --header "x-api-key: ${VE_BANKING_API_KEY}" \
  --data '{
    "usdAmount": 12.50,
    "debtorId": "V12345678",
    "debtorCellPhone": "584121234567",
    "debtorBankCode": 102,
    "externalRef": "order_demo_1042"
  }'

2. Ejecuta el pago con el token

curlbash

curl --request POST "${API_URL}/v1/payments/c2p" \
  --header "content-type: application/json" \
  --header "x-api-key: ${VE_BANKING_API_KEY}" \
  --data '{
    "intentId": "00000000-0000-4000-8000-000000000000",
    "usdAmount": 12.50,
    "debtorId": "V12345678",
    "debtorCellPhone": "584121234567",
    "debtorBankCode": 102,
    "token": "123456",
    "externalRef": "order_demo_1042"
  }'

JavaScriptjavascript

const payment = await fetch(
  `${process.env.API_URL}/v1/payments/c2p`,
  {
    method: 'POST',
    headers: {
      'content-type': 'application/json',
      'x-api-key': process.env.VE_BANKING_API_KEY,
    },
    body: JSON.stringify({
      intentId,
      usdAmount: 12.5,
      debtorId: 'V12345678',
      debtorCellPhone: '584121234567',
      debtorBankCode: 102,
      token: customerProvidedToken,
      externalRef: 'order_demo_1042',
    }),
  }
);