Fetch Transaction Details V3
curl --request GET \
--url https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id} \
--header 'Authorization: Bearer <token>'const url = 'https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}")
.header("Authorization", "Bearer <token>")
.asString();import requests
url = "https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"id": "6b2f1d7e-8c4a-4f3e-9a1b-2c3d4e5f6a7b",
"transaction_type": "ONRAMP",
"customer_id": "9f8e7d6c-5b4a-4c3d-8e2f-1a2b3c4d5e6f",
"beneficiary_id": null,
"hash": "0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2",
"status": "COMPLETED",
"reason": null,
"virtual_account_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"pay_in_id": null,
"created_at": "2026-10-07T08:05:12.114Z",
"updated_at": "2026-10-07T08:09:41.902Z",
"batch_info": null,
"fiat_details": {
"source_amount": 70,
"source_currency": "USD",
"destination_amount": 69.3,
"destination_currency": "USDC",
"fx_rate": 1,
"tracking_info": null
},
"crypto_details": {
"source_amount": null,
"source_currency": null,
"source_rail": null,
"source_address": null,
"destination_amount": null,
"destination_currency": null,
"destination_rail": null,
"destination_address": null,
"tx_hash": "0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2"
},
"fees": {
"developer_fee": {
"fixed": 0,
"percentage": 0.7
},
"total_developer_fee": 0.7,
"network_fee": 0,
"conversion_fee": 0,
"platform_fee": 0,
"total_fee": 0.7
},
"depositor": {
"name": "DEEPYTICS LTD",
"account_number": null,
"bank_name": "JPMorgan Chase",
"contact": null,
"address": "161994 York House Green Lane West, Preston, GB, PR3 1NJ",
"rail": "ACH",
"reference": "ACH Credit 021000028004799 DEEPYTICS LTD WISE",
"bank_reference": "021000028004799",
"received_at": "2026-10-07T08:00:08Z"
}
}
}
Transaction Details
Fetch Transaction Details V3
Returns one transaction with its fiat or crypto details, fee breakdown, batch linkage and, for on-ramps, the depositor (the party that sent the fiat). A transaction is only visible to the client that owns the customer it belongs to.
GET
/
v3
/
transactions
/
{transaction_id}
Fetch Transaction Details V3
curl --request GET \
--url https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id} \
--header 'Authorization: Bearer <token>'const url = 'https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}")
.header("Authorization", "Bearer <token>")
.asString();import requests
url = "https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.api.engagexpay.com/v3/transactions/{transaction_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"id": "6b2f1d7e-8c4a-4f3e-9a1b-2c3d4e5f6a7b",
"transaction_type": "ONRAMP",
"customer_id": "9f8e7d6c-5b4a-4c3d-8e2f-1a2b3c4d5e6f",
"beneficiary_id": null,
"hash": "0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2",
"status": "COMPLETED",
"reason": null,
"virtual_account_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"pay_in_id": null,
"created_at": "2026-10-07T08:05:12.114Z",
"updated_at": "2026-10-07T08:09:41.902Z",
"batch_info": null,
"fiat_details": {
"source_amount": 70,
"source_currency": "USD",
"destination_amount": 69.3,
"destination_currency": "USDC",
"fx_rate": 1,
"tracking_info": null
},
"crypto_details": {
"source_amount": null,
"source_currency": null,
"source_rail": null,
"source_address": null,
"destination_amount": null,
"destination_currency": null,
"destination_rail": null,
"destination_address": null,
"tx_hash": "0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2"
},
"fees": {
"developer_fee": {
"fixed": 0,
"percentage": 0.7
},
"total_developer_fee": 0.7,
"network_fee": 0,
"conversion_fee": 0,
"platform_fee": 0,
"total_fee": 0.7
},
"depositor": {
"name": "DEEPYTICS LTD",
"account_number": null,
"bank_name": "JPMorgan Chase",
"contact": null,
"address": "161994 York House Green Lane West, Preston, GB, PR3 1NJ",
"rail": "ACH",
"reference": "ACH Credit 021000028004799 DEEPYTICS LTD WISE",
"bank_reference": "021000028004799",
"received_at": "2026-10-07T08:00:08Z"
}
}
}
Any fiat transactions submitted between 9:30 AM and 5:30 PM ET on a weekday are processed the same day. Transactions submitted outside these hours or on weekends will be settled the next business day.
What changed from V2
V3 adds thedepositor object to the response. Everything else is identical to Fetch Transaction Details V2. No X-Idempotency-Key is needed.
The depositor object
Who sent the fiat for an on-ramp, as reported by the receiving bank. It is null for every other transaction type, for on-ramps where the banking partner did not report a sender, and for on-ramps created before this field existed.
Every field is nullable. Which fields are present depends on how the money arrived:
| Field | Wire (Fedwire / SWIFT) | ACH international (IAT) | ACH domestic |
|---|---|---|---|
name | yes | yes | yes |
account_number | yes | no, ACH does not carry the sender’s account | no |
bank_name | when the bank message includes it | yes | no |
contact | rarely, phone and/or email as free text when the bank message includes it | no | no |
address | yes | yes | no |
rail | FEDWIRE or SWIFT | ACH | ACH |
reference | the sender’s memo line | memo plus any remittance text | memo plus any remittance text |
bank_reference | IMAD | ACH trace number | ACH trace number |
received_at | when the bank posted the payment | same | same |
Treat
account_number and contact as optional in your integration: they are absent for all ACH payments, and contact is absent for almost all wires.Example: wire on-ramp
"depositor": {
"name": "M A HOLDINGS LIMITED",
"account_number": "MU57WPBL3301111031300102002USD",
"bank_name": null,
"contact": null,
"address": "117 ARCH MAKARIOU III AV, 4 FLOOR OFFICE 402,3021 LIMASSOL, CYPRUS",
"rail": "SWIFT",
"reference": "LOAN AGREEMENT",
"bank_reference": "20261021B1Q8383C010186",
"received_at": "2026-10-21T16:11:25Z"
}
Status values
status | Meaning |
|---|---|
INITIATED | Transaction created, funds not yet received. |
FUNDS_RECEIVED | Fiat (on-ramp) or crypto (off-ramp) has arrived. |
IN_COMPLIANCE | Under compliance review. |
PROCESSING | Payout submitted or in progress. |
COMPLETED | Settled. |
FAILED | Terminal failure; see reason. |
REFUNDED | Funds returned to the sender. |
Authorizations
Bearer token authentication. Obtain token from Issue a Token endpoint
Path Parameters
The transaction id returned when the transaction was created or listed.
Response
Transaction details retrieved successfully
Show child attributes
Show child attributes
⌘I