Skip to main content
POST
Commit a transaction intent

Authorizations

Authorization
string
header
required

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

X-Meridian-Api-Key
string

Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.

X-Meridian-Timestamp
string

Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.

X-Meridian-Program-Id
string

Server-to-server (HMAC) requests only. Identifies the program context for the request.

X-Meridian-User-Id
string

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

transactionIntentId
string
required

ID of the transaction intent to commit — the id returned by POST /v1/transaction-intents.

Body

application/json

Idempotency key guarding the commit

Idempotency key that guards committing a transaction intent exactly once.

idempotencyKey
string
required

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.

Example:

"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.

id
string
required

Unique identifier of the transaction intent

Example:

"txnint_01JMERINTENT001"

type
enum<string>
required

Type of transaction the intent would create

Available options:
TRANSFER,
DEPOSIT,
WITHDRAWAL,
REFUND,
PARTIAL_REFUND
Example:

"TRANSFER"

createdAt
string<date-time>
required

Timestamp when the transaction intent was created

Example:

"2026-04-30T15:00:00Z"

updatedAt
string<date-time>
required

Timestamp when the transaction intent was last updated

Example:

"2026-04-30T15:02:00Z"

status
enum<string>
required

Current status of the transaction intent

Available options:
CREATED,
EXPIRED,
CANCELED,
COMMITTED,
FAILED
Example:

"CREATED"

debitAmount
string
required

Amount to be debited as a decimal string

Example:

"7250.00"

debitCurrency
string
required

ISO 4217 currency code on the debit side

Example:

"USD"

debitInstrument
Account Instrument · object
required

Meridian (balance) account instrument

creditAmount
string
required

Amount to be credited as a decimal string

Example:

"7250.00"

creditCurrency
string
required

ISO 4217 currency code on the credit side

Example:

"USD"

creditInstrument
Account Instrument · object
required

Meridian (balance) account instrument

fees
Transaction Fee · object[]
required

Fees that would be applied to the transaction

exchangeRate
string
required

Exchange rate that would be applied

Example:

"1"

statusReason
string | null

Reason for the current status

ID of the transaction created when the intent was committed

debitMemo
string | null

Debit-side memo or reference text supplied when the intent was created

Example:

"INV-23014"

purpose
enum<string> | null

Payment purpose

Available options:
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