Consulta por referencia

Esta consulta te permite obtener información detallada de una dispersión específica utilizando su código de identificación. Cada dispersión está vinculada a un comercio, por lo que es importante que el código de transacción coincida con tu comercio, de lo contrario no recibirás un resultado exitoso.

El external_reference es un identificador único asignado a cada transacción, siendo esta la forma en que se distinguen en Trazo.

Ruta

GET /v1/merchant/payout/{external_reference}

Encabezado

Name	Description
x-auth-token*	Es el código generado a partir del proceso de autenticación. Ejemplo: 8dsa819dj736f1d87fdhd172f12ddw
Content-Type*	Es el tipo de contenido que se está enviando en la solicitud. Ejemplo: application/json

Respuesta

200

{
    "status": "CANCELED",
    "amount": "20000.00",
    "channel": "EMAIL",
    "type": "payout",
    "currency": "COP",
    "description": "PRUEBA",
    "reference_one": "Referencia 1",
    "reference_two": "Referencia 2",
    "reference_three": "Referencia 3",
    "reference_four": "Referencia 4",
    "merchant_phone": null,
    "merchant_email": "[email protected]",
    "receiver": {
        "phone": "573112222333",
        "email": "[email protected]",
        "first_name": "DIEGO",
        "last_name": "PEREZ",
        "id_type": "CC",
        "id_number": "12345678999"
    },
    "bank_account": {
        "entity": "Banco De Occidente",
        "type": "SAVINGS",
        "number": "9876543210",
        "reference": null
    },
    "approval": {
        "name": " ",
        "method": "TOKEN",
        "date": null
    },
    "updated_at": "2024-08-27T20:02:59.928Z"
}

400

{
    "error": "No results were found for the search query. Please check the search parameters and try again."
}

Ejemplo

cURL

curl --location --request GET '{{base_url}}/v1/merchant/payout/{{external_reference}}' \
--header 'x-auth-token: {{token}}' \
--data-raw ''

NodeJs (Axios)

var axios = require('axios');
var data = '';

var config = {
  method: 'get',
  url: `${base_url}/v1/merchant/payout/${external_reference}`,
  headers: { 
    'x-auth-token': token //Añadir token
  },
  data : data
};

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

Python

import requests

url = f"{base_url}/v1/merchant/payout/{external_reference}"

payload = ""
headers = {
  'x-auth-token': token #Añadir token
}

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