post https://payment-backend-sandbox.milio.com.co/payment-bico/create-transfer
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
Campo | Tipo | Descripción |
---|---|---|
amount | Double | Monto de la transacción en la moneda configurada (ejemplo: 2500.00). |
card | Object | (Solo en pagos sin tokenizar) Datos de la tarjeta de crédito/débito ingresada manualmente. |
cardNumber | String | Número de tarjeta de crédito/débito. |
cardExpiryDate | String | Fecha de vencimiento en formato "MM/YY" . |
cardCVV | String | Código de seguridad de la tarjeta. |
cardName | String | Nombre del titular de la tarjeta. |
phone | String | (Solo en pagos sin tokenizar) Teléfono del usuario que realiza la transacción. |
third | String | (Solo en pagos sin tokenizar) Nombre del beneficiario de la transacción. |
thirdBankUUID | String | (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.