Skip to content
Vesvank

Payment Request object

El objeto Payment Request representa una solicitud de pago creada a través de la API de Vesvank. Este objeto contiene toda la información relevante para procesar, rastrear y gestionar un pago solicitado a un cliente.

Atributos

Section titled “Atributos”
id (string)
Identificador único de la solicitud de pago.
description (string)
Descripción de la solicitud de pago.
external_id (string)
Identificador externo opcional definido por el usuario.
token (string)
Token único de la solicitud de pago.
status (string)
Estado actual de la solicitud (waiting_for_payment, paid, canceled, etc.).
created_at (integer)
Fecha y hora de creación (timestamp UNIX).
updated_at (integer)
Fecha y hora de última actualización (timestamp UNIX).
main_amount (object)
Monto principal solicitado.
amount_cents (integer)
Monto en centavos.
amount (float)
Monto en la moneda, con decimales.
currency_iso (string)
Código ISO de la moneda.
conversion_amount (object)
Monto convertido a otra moneda.
amount_cents (integer)
Monto en centavos.
amount (float)
Monto en la moneda, con decimales.
currency_iso (string)
Código ISO de la moneda.
customer (object)
Información del cliente asociado a la solicitud.
id (string)
ID del cliente.
dni (string)
Número de identificación del cliente.
email (string)
Correo electrónico del cliente.
rate (object)
Tasa de conversión usada.
amount_cents (integer)
Valor de la tasa en centavos.
amount (float)
Valor de la tasa, con decimales.
currency_iso (string)
Código ISO de la moneda.
succeeded_payment_intent (object)
Información del pago exitoso asociado.
id (string)
ID de la intención de pago.
confirmed_at (timestamp)
Fecha de confirmación del pago.
payment_method (string)
Método de pago utilizado.
provider_name (string)
Nombre del proveedor de pago.
reference_id (string)
Referencia del pago.
pending_payment_intents (array)
Lista de las intenciones de pago pendientes.
id (string)
ID de la intención de pago.
payment_method (string)
Método de pago utilizado.
provider_name (string)
Nombre del proveedor de pago.
reference_id (string)
Referencia del pago.
rejected_payment_intents (array)
Lista de las intenciones de pago rechazados.
id (string)
ID de la intención de pago.
payment_method (string)
Método de pago utilizado.
provider_name (string)
Nombre del proveedor de pago.
reference_id (string)
Referencia del pago.
rejection_reasons (array)
Motivos de rechazo (códigos y mensajes).
payment_url (string)
URL única para acceder al portal de pagos.

Ejemplo de objeto

Section titled “Ejemplo de objeto”
{
  "id": "preq_MpP9ewqdNEertAmNOZvyJjY7",
  "description": "My first payment request",
  "external_id": "order_0001",
  "token": "PR5a0357ca",
  "status": "paid",
  "created_at": 1747349972,
  "updated_at": 1747351268,
  "main_amount": {
    "amount_cents": 1000,
    "amount": 10.0,
    "currency_iso": "USD"
  },
  "conversion_amount": {
    "amount_cents": 90500,
    "amount": 950.0,
    "currency_iso": "VES"
  },
  "customer": {
    "id": "cus_Pn4r3mwOX5gDf50zpyKYl7Ze",
    "dni": "V1000000",
    "email": "example@vesvank.com"
  },
  "rate": {
    "amount_cents": 9050,
    "amount": 90.5,
    "currency_iso": "VES"
  },
  "succeeded_payment_intent": {
    "id": "pi_Vj8N1RZM5Eo4C3gm2rw7b9xp",
    "confirmed_at": 1847521630,
    "payment_method": "c2p",
    "provider_name": "mercantil_bank",
    "reference_id": "000000000006791"
  },
  "pending_payment_intents": [],
  "rejected_payment_intents": [],
  "payment_url": "https://subdomain.vesvank.com/payments_portal/payment_requests/PR5a0357ca"
}