Crear referencia de pago

El objetivo de este endpoint es generar una referencia de pago para transacciones pendientes de conciliación. Las transacciones serán las asociadas al ID suministrado. Además de la referencia de pago (payment_reference), que se utiliza para la transacción con nuestros corresponsales, también se incluye el ID del proceso (process_id) para identificar la solicitud de conciliación y las transacciones asociadas. Adicionalmente, se proporcionan hasta cuatro proveedores con los que tenemos convenios. Estos proveedores pueden ser personalizados, y se presentan con el nombre del convenio, el número del convenio y, si es necesario, la ubicación del punto o puntos más cercanos.

El ID solo se puede obtener mediante una solicitud al endpoint 'Obtener opciones de montos'.

Ruta

POST/v1/merchant/conciliation-points/{id}

Encabezado

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

Cuerpo

Información general

Name	Type	Description
process_id*	string	Identificador de la combinación de transacciones seleccionada desde el endpoint "Obtener opciones de montos".
provider*	numeric	Código que identifica al corresponsal aliado donde se va realizar la consignación. Opciones de provider Ejemplo: 2001

Opciones de provider

Nombre	Tipo	Código
Bancolombia	Cajero	2001
Bancolombia	Corresponsal	2002
Bancolombia	Banco	2003
SuperGiros	Corresponsal	2004
Pagatodo	Corresponsal	2005
Efecty	Corresponsal	2006
Bancamía	Banco	2008
BBVA	Banco	2009
Davivienda	Cajero	2010
Davivienda	Banco	2011
Puntored	Corresponsal	2012

Información locación

Cuando se agrega el objeto location se proporcionará la ubicación del proveedor más cercano entre los proveedores seleccionados en la lista de proveedores (provider). El objeto es opcional.

Name	Type	Description
latitude*	numeric	La latitud representa la coordenada geográfica que indica la posición norte o sur del ecuador terrestre para la ubicación del transportador. Ejemplo: 4.659881
longitude*	numeric	La longitud representa la coordenada geográfica que indica la posición este u oeste del meridiano principal para la ubicación del transportador. Ejemplo: -74.089077

Respuesta

200: location = true

{
    "process_id": "f8257db8ae",
    "quantity": 10,
    "amount": 2500000,
    "payment_reference": "371963",
    "locations": [
        {
            "provider": "BANCOLOMBIA",
            "agreement_name": "Recaudo Logístico Qentaz",
            "agreement_number": 8790,
            "location": {
                "name": "294 CARULLA SAN RAFAEL",
                "address": " CE PASEO SAN RAFAEL LC 105",
                "distance": "A 1,82 kilómetros",
                "latitude": 4.7109886,
                "longitude": -74.072092,
                "url": "https://maps.qentaz.com/3e657"
            }
        },
        {
            "provider": "PAGATODO",
            "agreement_name": "Recaudo Logístico Qentaz",
            "agreement_number": 38778,
            "location": {
                "address": "Carrera 70D # 127 - 48 CC NIZA",
                "distance": "A 0.3 km",
                "longitude": -74.072092,
                "latitude": 4.7109886,
                "url": "https://maps.qentaz.com/2mql2"
            }
        },
        {
            "provider": "PUNTORED",
            "agreement_name": "Recaudo Logístico Qentaz",
            "agreement_number": 1533629,
            "location": {
                "name": "GIROS Y FINANZAS CF SA",
                "address": "AV CL 127 NO 6092 L66",
                "distance": "A 0.14 kms",
                "longitude": -74.072092,
                "latitude": 4.7109886,
                "url": "https://maps.qentaz.com/om5mx"
            }
        }
    ],
    "created_at": "2024-08-27T13:56:05+00:00"
}

200: location = false

{
    "process_id": "0bbc909f5d",
    "quantity": 10,
    "amount": 2500000,
    "payment_reference": "735964",
    "created_at": "2024-08-27T13:55:26+00:00"
}

401

{
    "status": "unauthorized",
    "code": "Q103",
    "error": "El x-auth-token se encuentra vencido. Por favor genera un nuevo token y reintenta de nuevo el cobro."
}

Ejemplo

cURL

curl --location '{{base_url}}/v1/merchant/conciliation' \
--header 'x-auth-token: {{token}}' \
--header 'Content-Type: application/json' \

--data '{
    "process_id": "0afab5e2",
    "provider": 2001
    "location": {
        "latitude":  4.7109886,
        "longitude": -74.072092
    }
}'

NodeJS (Axios)

const axios = require('axios');
let data = JSON.stringify({
  "process_id": "0afab5e2",
  "provider": 2001
  "location": {
    "latitude": 4.7109886,
    "longitude": -74.072092,
    
  }
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/merchant/conciliation`,
  headers: { 
    'x-auth-token': token, //Añadir token 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import requests
import json

url = f"{base_url}/v1/merchant/conciliation"

payload = json.dumps({
  "process_id": "0afab5e2",
  "provider": 2001
  "location": {
    "latitude": 4.7109886,
    "longitude": -74.072092,
    
  }
})
headers = {
  'x-auth-token': token, #Añadir token
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)