Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Consulta por referencia

Esta consulta te permite obtener información detallada de una transacción específica utilizando su código de identificación. Cada transacció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/transaction/{external_reference}

Cuerpo

Name
Value

Content-Type

application/json

x-auth-token*

{token}

child-id

{business_id}

El child-id es opcional y se usa para las cuentas administradas para conocer más puedes ingresa a este enlace.

Respuesta

{
    "external_reference": "61BUD1R4A",
    "process_id": "62d61cb6-acec-4ee6-96ba-d3d278b56846",
    "description": "Descripción Transacción (con recargo)",
    "status": "CREATED",
    "amount": 1000,
    "expected_amount": 100000,
    "channel": "WHATSAPP",
    "currency": "COP",
    "reference_one": "Referencia 1",
    "reference_two": "Referencia 2",
    "reference_three": "Referencia 3",
    "reference_four": "Referencia 4",
    "reference_five": "Referencia 5",
    "reference_six": "Referencia 6",
    "reference_seven": "Referencia 7",
    "reference_eight": "Referencia 8",
    "expiration": false,
    "attachment": null,
    "comments": null,
    "payment_method": null,
    "payment_provider_source": null,
    "receipt_image": null,
    "type": "inmediato",
    "source": "api",
    "merchant": {
        "name": "DIEGO PEREZ",
        "phone": "573110011111",
        "email": "diego@gmail.com",
        "id_number": "1000011111",
        "id_type": "CC"
    },
    "payer": {
        "name": "ALEJANDRO PEREZ",
        "phone": "573110011111",
        "email": "diego@gmail.com",
        "id_number": "1000011111",
        "id_type": "CC"
    }
    "affiliate": {
        "name": "ALEJANDRO PEREZ",
        "id_number": "1000011111",
        "id_type": "CC"
    },
    "invoice": {
        "provider": null,
        "type": null,
        "id": null,
        "retentions": null,
        "url": null,
        "voucher": null
    },
    "fees": {
        "service_fee": null,
        "service_variable": null,
        "service_iva": null,
        "service_saas": null,
        "fee_settled": null,
        "saas_settled": null
    },
    "late_fees": [
        {
            "id": 7018,
            "date": "2025-06-15",
            "value": 1000,
            "reminder": true,
            "reminder_template": "credit_late_fee_2"
        },
        {
            "id": 7019,
            "date": "2025-06-27",
            "value": 1000,
            "reminder": true,
            "reminder_template": "credit_late_fee_3"
        }
    ],
    "advance_payments": null,
    "payout_process_status": false,
    "payout_process_id": null,
    "return_review_reason": null,
    "return_success_reason": null,
    "cash_manual_process_status": false,
    "cash_manual_reason": null,
    "limit_date": "2025-05-22",
    "expected_date": null,
    "created_at": "2025-05-07T16:31:56.503Z",
    "updated_at": "2025-06-17T15:47:45.983Z"
}

Ejemplo

Última actualización