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.

Los pagos con QR desde la app del banco están disponibles solo para Nequi y Bancolombia. Si utilizas otro banco o método de pago, el QR redirigirá a la página del banco o experiencia de pago definida (no se podrá escanear desde la app).

---

Ruta

POST /v1/merchant/payment/intent

Encabezado

Name	Value
Content-Type*	application/json
x-auth-token*	{token}

Cuerpo

Name	Type	Description
external_reference*	string	Identificador de la transacción. Ejemplo: a1a1a1
method.type*	string	Tipo de proceso de pago. bank | wallet | cash | qr
method.processor	string	Procesador o entidad elegida para el pago. Requerido si es otp o push. Ejemplo: 2001
method.user_id_type	string	[Opcional] Tipo de identificación del usuario CC | NIT | CE
method.user_id_number	string	[Opcional] Número de identificación del usuario Ejemplo: 12345678
method.location.longitude	string	Longitud de la ubicación del usuario. Ejemplo: 4.12345678
method.location.latitude	string	Latitud de la ubicación del usuario. Ejemplo: -72.12345678

Respuesta

Wallet

{
"external_reference": "a1a2a3",
"method": {
   "type": "wallet", 
   "processor": 1551,
   "user_id": "12345678" 
   }
}

Bank

{
"external_reference": "a1a2a3",
"method": {
   "type": "bank", 
   "processor": 1007
   }
}

QR

{
"external_reference": "a1a2a3",
"method": {
   "type": "qr"
   }
}

Cash

{
"external_reference": "a1a2a3",
"method": {
   "type": "wallet", 
   "processor": 1551,
   "location": {
      "longitude": "4.7234134",
      "latitude": "-72.6125125",
      }
   }
}

Ejemplo

200 OK (Wallet)

{
    "external_reference": "8d966f",
    "method": "wallet",
    "process":{
        "type": "otp" 
        "status": "sent", 
        "url": "pago.trazo.co/comercio/t/A1A2A3", 
        "expire_in": 15000
    }
}

200 OK (Cash)

{
    "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"
            }
        ]
    }
}

200 OK (QR)

{
    "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="                
    }
}

400

{
    "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}]"
}