API Reference

Generación QR de cobro

Un pago por qr es una transacción que se realiza por un monto fijo, se especifica la cuenta de destino y se genera el QR.

Objeto Json

Sin tokenización

{
    "amount": 200.00,
    "card": {
        "cardNumber": "{{card1}}",
        "cardExpiryDate": "12/26",
        "cardCVV": "123",
        "cardName": "{{$randomFirstName}} {{$randomFirstName}} {{$randomLastName}}"
    },
    "phone": "3026580102",
    "third": "{{$randomFirstName}} {{$randomFirstName}} {{$randomLastName}}",
    "qr": true
}

Con tarjeta tokenizada

{
    "amount": 200.00,
    "thirdBankUUID": "123334556",
    "qr": true
}

Detalles Clave

  • Cuenta destino: Tarjeta de débito de una persona natural de cualquier banco.

Este método es útil para clientes que necesitan recolectar pagos de manera eficiente y segura.

📌 Explicación de los Campos

CampoTipoDescripción
amountDoubleMonto de la transacción en la moneda configurada (ejemplo: 2500.00).
cardObject(Solo en pagos sin tokenizar) Datos de la tarjeta de crédito/débito ingresada manualmente.
cardNumberStringNúmero de tarjeta de crédito/débito.
cardExpiryDateStringFecha de vencimiento en formato "MM/YY".
cardCVVStringCódigo de seguridad de la tarjeta.
cardNameStringNombre del titular de la tarjeta.
phoneString(Solo en pagos sin tokenizar) Teléfono del usuario que realiza la transacción.
thirdString(Solo en pagos sin tokenizar) Nombre del beneficiario de la transacción.
thirdBankUUIDString(Solo en pagos tokenizados) Identificador único del banco receptor.

Respuesta del Registro de Pago

La respuesta del endpoint

{
    "message": "Transacción creada",
    "data": {
        "accountNumber": "************4242",
        "fullName": "Howell Eve Goyette"
    },
    "qr": "data:image/png;base64,...."
}

En la respuesta se entrega el QR en formato Base64 Data URI. Este código QR es esencial para el proceso de pago, ya que encapsula la información de la cuenta destino y el monto a abonar. El cliente que realizará el pago debe escanear este código para proceder con la transacción.

Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!