Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iterapay.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to retrieve the details of a single transaction associated with a merchant account. Transactions are created when a customer makes a payment against an invoice, and this endpoint provides the complete record including on-chain confirmation data.

Path parameters

merchantID
string
required
The UUID of the merchant account that the transaction belongs to.
transactionID
string
required
The UUID of the transaction to retrieve.

Response

id
string
required
The UUID of the transaction.
invoiceID
string
required
The UUID of the invoice this transaction is associated with.
amount
string
required
The transaction amount as a decimal string.
state
string
required
The current state of the transaction (e.g., pending, confirmed, failed).
createdAt
string
required
ISO 8601 timestamp of when the transaction was created.
confirmedAt
string
ISO 8601 timestamp of when the transaction was confirmed on-chain. null if not yet confirmed.
txHash
string
The on-chain transaction hash. null if the transaction has not yet been broadcast to the network.
curl --request GET \
  --url https://api.iterapay.com/merchants/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f/transactions/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f \
  --header 'Authorization: Bearer <token>'
{
  "id": "b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f",
  "invoiceID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "amount": "100.00",
  "state": "confirmed",
  "createdAt": "2024-01-15T10:30:00Z",
  "confirmedAt": "2024-01-15T10:35:12Z",
  "txHash": "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16"
}