MOmonato
Transactions

Retrieve a transaction

Changed on

Returns a single transaction owned by the client. Use it to check the current status of a Money Out, a Money In, or a Penny Validation outside the webhook flow. For Penny Validation, metadata.dataCep carries the CEP data; see the CEP statuses guide for how that status evolves.

get/v1/clients/{clientId}/transactions/{transactionId}

Request

Path parameters

clientIdstring uuid required

Client UUID that owns the transaction.

transactionIdstring uuid required

Transaction UUID, as delivered in webhooks or stored by your system.

Response

The requested transaction.

idstring uuid required

Transaction UUID.

bankIdstring uuid required

Bank UUID used by the source account.

clientIdstring uuid required

Client UUID that owns the transaction.

externalReferencestring required

Client-provided numeric reference.

trackingIdstring required

Tracking key assigned to the transaction for reconciliation.

descriptionstring required

Payment concept sent with the transaction.

amountstring required

Decimal amount as a string with exactly two decimal places.

currency'MXN' required
category'CREDIT_TRANS' | 'DEBIT_TRANS' | 'INTER_TRANS' | 'OTHER' required
subCategory'OTHERS' | 'SPEI_CREDIT' | 'SPEI_DEBIT' | 'INT_DEBIT' | 'INT_CREDIT' | 'SPEI_REFUNDED' | 'SPEI_REFUNDED_CREDIT' | 'SPEI_REFUNDED_DEBIT' | 'INT_ADJ_CREDIT' | 'INT_ADJ_DEBIT' required
transactionStatus'INITIALIZED' | 'IN_PROGRESS' | 'LIQUIDATED' | 'CANCELLED' | 'REFUNDED' | 'REJECTED' | 'DECLINED' required
originalTransactionIdstring uuid

Present on refund-related transactions.

refundTransactionIdstring uuid

Present on original transactions after refund.

clientReferencestring

Optional client reference returned when it was supplied in the request.

jsonReferencestring

Raw reference payload stored for the transaction. Can be empty.

transactionDatestring

Mexico City local time (UTC-6) when the transaction was processed. Returned without a UTC offset, unlike the timestamps in audit.

Example response

{
  "id": "16811ee8-1ef9-4dd4-8d84-9c2df89cf302",
  "bankId": "9d84b03a-28d1-4898-a69c-38824239e2b1",
  "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
  "externalReference": "1234567",
  "trackingId": "20250306FINCHVLIKQ5SKUM",
  "description": "Supplier payment",
  "amount": "5000.00",
  "currency": "MXN",
  "category": "DEBIT_TRANS",
  "subCategory": "SPEI_DEBIT",
  "transactionStatus": "INITIALIZED",
  "audit": {
    "createdAt": "2025-03-06 11:57:55.408000-06:00",
    "updatedAt": "2025-03-06 11:57:55.408000-06:00"
  },
  "sourceInstrument": {
    "id": "709448c3-7cbf-454d-a87e-feb23801269a",
    "bankId": "9d84b03a-28d1-4898-a69c-38824239e2b1",
    "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
    "ownerId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
    "instrumentAlias": "Centralizing account",
    "instrumentStatus": "ACTIVE",
    "instrumentType": "RECEIVER",
    "instrumentDetail": {
      "cardNumber": "5579072268574100",
      "holderName": "John Smith"
    },
    "rfc": "XAXX010101000",
    "customerId": "bb1e8fde-e68e-48e9-a483-d32153c752c2"
  },
  "destinationInstrument": {
    "id": "709448c3-7cbf-454d-a87e-feb23801269a",
    "bankId": "9d84b03a-28d1-4898-a69c-38824239e2b1",
    "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
    "ownerId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
    "instrumentAlias": "Centralizing account",
    "instrumentStatus": "ACTIVE",
    "instrumentType": "RECEIVER",
    "instrumentDetail": {
      "cardNumber": "5579072268574100",
      "holderName": "John Smith"
    },
    "rfc": "XAXX010101000",
    "customerId": "bb1e8fde-e68e-48e9-a483-d32153c752c2"
  },
  "originalTransactionId": "a1392ef1-23f5-4e15-90cd-5d3d8d24d839",
  "refundTransactionId": "957459ce-d4e3-40b5-b759-373e844ba1e8",
  "metadata": {
    "dataCep": {
      "cepUrl": "https://www.banxico.org.mx/cep/...",
      "validationId": "f4ebe9af-50ac-42e5-97c7-3164d2693d6e",
      "beneficiaryName": "John Smith",
      "beneficiaryRfc": "XAXX010101000",
      "status": "PENDING",
      "createdAt": "2025-08-15T22:42:39.327Z"
    },
    "dataReturn": {
      "trackingId": "20250510FINCHFL2SFGP9KT",
      "originalTrackingId": "20250509FINCHARNJK5NHQG",
      "reason": "CANCELLED_ACCOUNT",
      "reasonDescription": "Cuenta cancelada"
    }
  },
  "clientReference": "INV-4567",
  "transactionDate": "2026-09-23 14:24:58"
}

Changes