Intento de pago
Permite experiencias de pago sin complicaciones para los usuarios con pocos pasos y sin fricciones. Los usuarios pueden elegir entre múltiples métodos de pago, y la API proporcionará las opciones necesarias para completar las transacciones de manera segura y eficiente.
Ruta
POST /v1/merchant/payment/intent
Encabezado
Content-Type*
application/json
x-auth-token*
{token}
Cuerpo
external_reference*
Identificador de la transacción.
Ejemplo: a1a1a1
method.type*
Tipo de proceso de pago.
bank | wallet | cash | qr
method.processor
Procesador o entidad elegida para el pago. Requerido si es otp o push.
Ejemplo: 2001
method.user_id_type
[Opcional] Tipo de identificación del usuario
CC | NIT | CE
method.user_id_number
[Opcional] Número de identificación del usuario
Ejemplo: 12345678
method.location.longitude
Longitud de la ubicación del usuario.
Ejemplo: 4.12345678
method.location.latitude
Latitud de la ubicación del usuario.
Ejemplo: -72.12345678
Respuesta
{
"external_reference": "a1a2a3",
"method": {
"type": "wallet",
"processor": 1551,
"user_id": "12345678"
}
}{
"external_reference": "a1a2a3",
"method": {
"type": "bank",
"processor": 1007
}
}{
"external_reference": "a1a2a3",
"method": {
"type": "qr"
}
}{
"external_reference": "a1a2a3",
"method": {
"type": "wallet",
"processor": 1551,
"location": {
"longitude": "4.7234134",
"latitude": "-72.6125125",
}
}
}Ejemplo
{
"external_reference": "8d966f",
"method": "wallet",
"process":{
"type": "otp"
"status": "sent",
"url": "pago.trazo.co/comercio/t/A1A2A3",
"expire_in": 15000
}
}{
"external_reference": "8d966f",
"method": "cash",
"process": {
"payment_reference": "392378",
"providers": [
{
"name": "BANCOLOMBIA",
"agreement_name": "Recaudo Logístico Qentaz",
"agreement_number": "8790"
},
{
"name": "PUNTORED",
"agreement_name": "Recaudo Logístico Qentaz",
"agreement_number": "8790"
},
{
"name": "PAGATODO",
"agreement_name": "Recaudo Logístico Qentaz",
"agreement_number": "8790"
}
]
}
}{
"external_reference": "8d966f",
"method": "qr",
"process": {
"link": "https://pago.trazo.co/comercio/t/8d966f",
"qr-url": "https://content.trazo.co/qr/asf9g32ksdvk09323.png",
"qr-base64": "data:image/png;base64,iVBORw0KG[..]ORK5CYII="
}
}{
"status": "error",
"code": "PI_sda921r1f",
"message": "Uno o más campos no se encuentran diligenciados correctamente o están vacíos. Por favor revisa los campos [{campo}]"
}Última actualización