curl --request POST \
--url https://sandbox-api.va.meridianpay.com/v1/transaction-intents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"debitInstrumentId": "acc_01JMERUSDRET001",
"creditInstrumentId": "ba_01JMERPHSETTLE01",
"fixedSide": "DEBIT",
"amount": "250.00",
"idempotencyKey": "create-key-9f2c1b3a",
"memo": "Invoice INV-5530",
"externalId": "luno-payout-88213",
"purpose": "VENDOR_CONTRACTOR_PAYOUTS"
}
'{
"id": "txnint_01JMERINTENT001",
"type": "TRANSFER",
"createdAt": "2026-04-30T15:00:00Z",
"updatedAt": "2026-04-30T15:02:00Z",
"status": "CREATED",
"debitAmount": "7250.00",
"debitCurrency": "USD",
"debitInstrument": {
"account": {
"id": "acc_01JMEROAK7421",
"displayName": "Oak Street Purchase Contract",
"currency": "USD"
},
"instrumentType": "ACCOUNT"
},
"creditAmount": "7250.00",
"creditCurrency": "USD",
"creditInstrument": {
"account": {
"id": "acc_01JMEROAK7421",
"displayName": "Oak Street Purchase Contract",
"currency": "USD"
},
"instrumentType": "ACCOUNT"
},
"fees": [
{
"type": "PROCESSING",
"label": "Processing fee",
"amount": "1.00",
"currency": "USD"
}
],
"exchangeRate": "1",
"statusReason": "<string>",
"relatedTransactionId": "<string>",
"debitMemo": "INV-23014",
"externalId": "luno-payout-88213",
"purpose": "PAYMENT_FOR_SERVICES",
"creditRail": "ACH"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}Create a transaction intent
Creates a transaction-shaped preview from debit and credit payment instruments. The credit instrument may be a beneficiary bank account or a beneficiary blockchain wallet; a stablecoin payout must debit and credit the same currency. No funds movement occurs until the intent is committed.
curl --request POST \
--url https://sandbox-api.va.meridianpay.com/v1/transaction-intents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"debitInstrumentId": "acc_01JMERUSDRET001",
"creditInstrumentId": "ba_01JMERPHSETTLE01",
"fixedSide": "DEBIT",
"amount": "250.00",
"idempotencyKey": "create-key-9f2c1b3a",
"memo": "Invoice INV-5530",
"externalId": "luno-payout-88213",
"purpose": "VENDOR_CONTRACTOR_PAYOUTS"
}
'{
"id": "txnint_01JMERINTENT001",
"type": "TRANSFER",
"createdAt": "2026-04-30T15:00:00Z",
"updatedAt": "2026-04-30T15:02:00Z",
"status": "CREATED",
"debitAmount": "7250.00",
"debitCurrency": "USD",
"debitInstrument": {
"account": {
"id": "acc_01JMEROAK7421",
"displayName": "Oak Street Purchase Contract",
"currency": "USD"
},
"instrumentType": "ACCOUNT"
},
"creditAmount": "7250.00",
"creditCurrency": "USD",
"creditInstrument": {
"account": {
"id": "acc_01JMEROAK7421",
"displayName": "Oak Street Purchase Contract",
"currency": "USD"
},
"instrumentType": "ACCOUNT"
},
"fees": [
{
"type": "PROCESSING",
"label": "Processing fee",
"amount": "1.00",
"currency": "USD"
}
],
"exchangeRate": "1",
"statusReason": "<string>",
"relatedTransactionId": "<string>",
"debitMemo": "INV-23014",
"externalId": "luno-payout-88213",
"purpose": "PAYMENT_FOR_SERVICES",
"creditRail": "ACH"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}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
Body
Debit and credit instruments, the fixed side, the amount to price, and optionally the rail to pay the credit instrument over
Debit and credit payment instruments plus the amount to price a transaction intent. The intent is a preview only — no funds move until it is committed.
Identifier of the payment instrument to credit (the receiving side): a beneficiary bank account id, or a beneficiary blockchain wallet id for a stablecoin payout. Must differ from debitInstrumentId. When either instrument is a stablecoin, both must be in the same currency.
"ba_01JMERPHSETTLE01"
Amount to price on the fixedSide, as a decimal string in that side's currency. Must be at least 1 in that currency. A value carrying more precision than the currency holds is rounded to that currency's precision - two decimal places for a fiat currency, six for a stablecoin - rather than rejected, using banker's rounding, so 250.005 USD is priced as 250.00. The other side is then derived from the rounded value.
"250.00"
Optional identifier of your own for this payout, at most 64 characters. It becomes the resulting transaction's externalId, so GET /v1/transactions?externalId= finds it. Not checked for uniqueness: idempotencyKey, not externalId, is what guards against creating the payout twice.
"luno-payout-88213"
Optional payment purpose, used for compliance/reporting on cross-border payouts.
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 "VENDOR_CONTRACTOR_PAYOUTS"
Optional rail to pay the credit instrument over, e.g. ACH or WIRE for a US bank account, SWIFT for an international one, or the wallet's chain for a stablecoin payout. Must be one of the rails the credit instrument can be paid over. Omit to let payout routing choose the rail.
WIRE, ACH, RTP, SEPA, SEPA_INSTANT, SWIFT, EXTERNAL_WALLET, ETHEREUM, BASE, POLYGON, null "ACH"
Response
The created transaction intent preview
A transaction-shaped preview of a movement of funds. No funds move until the intent is committed.
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