Skip to main content
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"
}