Skip to content
Vesvank

Pago C2P

Procesa un pago usando el método C2P (Cuenta a Cuenta), sistema de transferencias interbancarias en tiempo real operado por el Banco Central de Venezuela (BCV). Este endpoint permite realizar pagos instantáneos entre cuentas de diferentes bancos venezolanos, utilizando la identificación del pagador y un código OTP para validar la transacción.

Endpoint

Section titled “Endpoint”
POST /api/v1/checkouts/c2p

Parámetros

Section titled “Parámetros”
payment (object) requerido
Información del pago C2P.
phone_number (string) requerido
Numero de telefono de la persona que realiza el pago.
issuer_payer_id (string) requerido
Identificación del pagador (cédula, pasaporte o RIF) de la persona que realiza el pago.
issuer_bank_id (string) requerido
Código BCV del banco de la persona que realiza el pago (0134: Mercantil, 0135: Banesco, etc).
payment_request_id (string) requerido
ID de la solicitud de pago que se requiere pagar.
otp_token (string) requerido
Código OTP para validar la transacción.

Respuesta

Section titled “Respuesta”

Retorna el objeto Payment Intent creado.

Códigos de estado

Section titled “Códigos de estado”
  • 201 Created - El pago fue exitoso
  • 401 Unauthorized - Error de autenticación
  • 402 Payment Required - El pago no pudo ser procesado (Cédula o RIF invalido, OTP inválido, etc)
  • 404 Not Found - No se encontro la solicitud de pago que se requiere pagar.
  • 422 Unprocessable Entity - Error de validación.

Ejemplo de solicitud

Section titled “Ejemplo de solicitud”
Terminal window
curl -X POST https://api.vesvank.com/api/v1/checkouts/c2p \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payment": {
      "phone_number": "4120000000",
      "issuer_payer_id": "V00000000",
      "issuer_bank_id": "0134",
      "payment_request_id": "preq_MpP9ewqdNEertnmNOZvyJjY7",
      "otp_token": "42424242"
    }
  }'

Ejemplo de respuesta

Section titled “Ejemplo de respuesta”
{
  "id": "preq_MpP9ewqdNEertnmNOZvyJjY7",
  "description": "My first payment with C2P",
  "external_id": "0000000001",
  "token": "PR2c083403",
  "status": "paid",
  "created_at": "2025-05-10T13:59:41.435-04:00",
  "updated_at": "2025-05-15T17:14:16.775-04:00",
  "main_amount": {
    "amount": 400.0,
    "currency_iso": "USD"
  },
  "conversion_amount": {
    "amount": 400.0,
    "currency_iso": "VES"
  },
  "customer": {
    "dni": "V00000000",
    "email": "example@vesvank.com"
  },
  "rate": {
    "amount": 1.0,
    "currency_iso": "VES"
  },
  "succeeded_payment_confirmation": {
    "id": "pi_kgy2MPj1m8xLFz7me8vGdZn9",
    "confirmed_at": "2025-05-15T17:14:16.768-04:00",
    "payment_method": "c2p",
    "type": "bancaribe_bank",
    "reference_id": "3194579836"
  },
  "pending_payment_intents": [],
  "rejected_payment_intents": [],
  "payment_url": "https://subdomain.vesvank.com/payments_portal/payment_requests/PR2c083403"
}