{format} path slug before you Base64-encode and submit a payout request.
Meridian currently accepts these payout origination formats:
| Path slug | Source payload | Use when |
|---|---|---|
pacs008 | ISO 20022 pacs.008.* XML document | You originate payouts from an existing ISO 20022 payment message |
json | JSON object | You want to submit a simpler structured payload where entityId, beneficiaryId, amount, currency, and reference are all required |
Common intake rules
These rules apply to every supported format:- Base64-encode the full source payload and send it as the raw
text/plainrequest body. - Sign the request with Meridian HMAC headers.
- Send
Idempotency-Keyas a separate request header. - Use
POST /v1/payout-origination/{format}with the correct path slug for your message type. - Preserve the exact payload bytes you want Meridian to process before you Base64-encode them.
Format-specific guides
- Use pacs.008 format for ISO 20022 XML submissions.
- Use JSON format for Base64-encoded JSON submissions.
Choosing a format
Choosepacs008 when your upstream system already produces a complete pacs.008.* payment message and you want Meridian to ingest that original XML.
Choose json when you do not have an ISO 20022 payload and want to originate the payout from a minimal JSON document where all of these fields and values are required:
entityIdbeneficiaryIdamountcurrencyreference