Transactions
Initiate, preview, and track payments across all supported rails.
Transactions
Transactions are the payments initiated by the GMA partner admin on behalf of customers to their counterparties. The API supports ACH, Domestic Wire, International Wire, Cross-Border (FX), and Stablecoin (USDC/PYUSD) payments.
Golden rule — always preview first
Every payment type has a matching preview endpoint. Call it before executing the payment to:
- Confirm fees, exchange rates, and final amounts
- Validate that the instrument and counterparty are eligible
- Detect routing issues before funds move
Payment types at a glance
| Payment type | Preview endpoint | Execute endpoint |
|---|---|---|
| ACH / Wire | /transactions/{userId}/payments/preview | /transactions/{userId}/payments |
| Cross-Border | /transactions/{userId}/cross-border/preview | /transactions/{userId}/cross-border |
| USDC | /transactions/{userId}/stablecoin/withdraw/preview | /transactions/{userId}/stablecoin/withdraw |
| PYUSD | /transactions/{userId}/pyusd/withdraw/preview | /transactions/{userId}/pyusd/withdraw |
Supporting documents
Cross-border payments often require a SupportingDocument (e.g. invoice). Upload the file via POST /transactions/upload first — it returns a fileId that you then pass as SupportingDocument in the payment request.
Searching transactions
POST /transactions— list all transactions across all users. Filter by date, type, and status.POST /transactions/user/{userId}— transactions for a specific user.GET /transactions/{userId}/{transactionId|transactionNumber}— fetch full details of a single transaction.
Transaction endpoints