Commit a transaction intent
Commits a created transaction intent. Commit is idempotent and creates at most one underlying Meridian transaction.
Authorizations
Bearer token authentication, for client-server calls.
Send the access token issued by POST /v1/auth/token as Authorization: Bearer {token}. The token carries its own program and user context, so the X-Meridian-* headers are not required. See Authentication.
Headers
Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.
Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.
Server-to-server (HMAC) requests only. Identifies the program context for the request.
Server-to-server (HMAC) requests only. Identifies the Meridian user targeted by the request. Required for MULTI_USER integrations; omit for SINGLE_USER.
Path Parameters
ID of the transaction intent to commit — the id returned by POST /v1/transaction-intents.
Body
Idempotency key guarding the commit
Idempotency key that guards committing a transaction intent exactly once.
Must equal the idempotencyKey used to create this intent — commit reuses the create key, and a mismatch is rejected with 409 Conflict. Commit is idempotent: repeating it with that key returns the same committed intent and creates at most one transaction.
"create-key-9f2c1b3a"
Response
The committed transaction intent, including the related transaction id when execution was created
A transaction-shaped preview of a movement of funds. No funds move until the intent is committed.
Unique identifier of the transaction intent
"txnint_01JMERINTENT001"
Type of transaction the intent would create
TRANSFER, DEPOSIT, WITHDRAWAL, REFUND, PARTIAL_REFUND "TRANSFER"
Timestamp when the transaction intent was created
"2026-04-30T15:00:00Z"
Timestamp when the transaction intent was last updated
"2026-04-30T15:02:00Z"
Current status of the transaction intent
CREATED, EXPIRED, CANCELED, COMMITTED, FAILED "CREATED"
Amount to be debited as a decimal string
"7250.00"
ISO 4217 currency code on the debit side
"USD"
Meridian (balance) account instrument
- Account Instrument
- Bank Account Instrument
- External Wallet Instrument
- Virtual Account Instrument
Amount to be credited as a decimal string
"7250.00"
ISO 4217 currency code on the credit side
"USD"
Meridian (balance) account instrument
- Account Instrument
- Bank Account Instrument
- External Wallet Instrument
- Virtual Account Instrument
Fees that would be applied to the transaction
Exchange rate that would be applied
"1"
Reason for the current status
ID of the transaction created when the intent was committed
Debit-side memo or reference text supplied when the intent was created
"INV-23014"
Payment purpose
PAYMENT_FOR_SERVICES, PAYMENT_FOR_SOFTWARE, PAYMENT_FOR_IMPORTED_GOODS, TRAVEL_SERVICES, VENDOR_CONTRACTOR_PAYOUTS, TRANSFER_TO_OWN_ACCOUNT, INVESTMENT_IN_SHARES, PURCHASE_OF_PROPERTY, REPAYMENT_OF_LOANS, SALARY, PAYMENT_OF_PROPERTY_RENTAL, INFORMATION_SERVICE_CHARGES, ADVERTISING_AND_PUBLIC_RELATIONS_EXPENSES, ROYALTY_TRADEMARK_PATENT_AND_COPYRIGHT_FEES, BROKER_FRONTEND_GUARANTEE_AND_CUSTODIAN_FEES, ADVISOR_TECHNICAL_AND_ACADEMIC_FEES, REPRESENTATIVE_OFFICE_EXPENSES, TAX_PAYMENT, TRANSPORTATION_FEES_FOR_GOODS, CONSTRUCTION_COSTS, INSURANCE_PREMIUM, GENERAL_GOODS_TRADES_OFFLINE, INSURANCE_CLAIMS_PAYMENT, FAMILY_MAINTENANCE, EDUCATION_RELATED_EXPENSES, MEDICAL_TREATMENT, DONATIONS, MUTUAL_FUND_INVESTMENT, CURRENCY_EXCHANGE, USER_WITHDRAWAL, ADVANCE_PAYMENTS_FOR_GOODS, VENDOR_CONTRACTOR_PAYOUTS_SOFTWARE_DEVELOPMENT, MERCHANT_SETTLEMENT, REPATRIATION_FUND_SETTLEMENT, PERSONAL_REMITTANCE, RETURN_OF_FUNDS, null