Skip to content
Vesvank

Pago con Tarjeta

Procesa pagos con tarjetas de crédito y débito Visa y Mastercard, tanto nacionales como internacionales. Este endpoint valida la información de la tarjeta y procesa la transacción de forma segura, permitiendo a tus clientes realizar pagos de manera rápida y confiable.

Endpoint

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

Parámetros

Section titled “Parámetros”
payment (object) requerido
Información del pago con tarjeta de crédito.
card_number (string) requerido
Número de la tarjeta de crédito/débito.
card_customer_id (string) requerido
Identificación del titular de la tarjeta (cédula, pasaporte o RIF).
card_expiry_date (string) requerido
Fecha de expiración de la tarjeta en formato MM/YY.
payment_request_id (string) requerido
ID de la solicitud de pago que se requiere pagar.
card_cvv (string) requerido
Código de seguridad de la tarjeta (CVV).

Respuesta

Section titled “Respuesta”

Retorna el objeto Payment Request actualizado.

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 (tarjeta inválida, fondos insuficientes, 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/credit_card \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payment": {
      "card_number": "4532310053045532",
      "card_customer_id": "V5011020",
      "card_expiry_date": "11/25",
      "payment_request_id": "preq_MpP9ewqdNEertAmNOZvyJjY7",
      "card_cvv": "499"
    }
  }'

Ejemplo de respuesta

Section titled “Ejemplo de respuesta”
{
  "id": "preq_MpP9ewqdNEertAmNOZvyJjY7",
  "description": "My first payment with credit card",
  "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": "V5011020",
    "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": "credit_or_debit_card",
    "type": "visa",
    "reference_id": "3194579836"
  },
  "pending_payment_intents": [],
  "rejected_payment_intents": [],
  "payment_url": "https://subdomain.vesvank.com/payments_portal/payment_requests/PR2c083403"
}