curl --request POST \
--url https://sandbox-api.va.meridianpay.com/v1/beneficiaries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"type": "BUSINESS",
"name": "Nimbus Settlement Ltd",
"displayName": "Nimbus Settlement Ltd",
"email": "treasury@nimbus-settlement.com",
"relationshipToUser": "THIRD_PARTY",
"address": {
"addressLine1": "25 Sir John Rogerson's Quay",
"city": "Dublin",
"stateProvince": "County Dublin",
"postalCode": "D02 XY45",
"countryCode": "IE"
},
"instrument": {
"type": "BLOCKCHAIN_WALLET",
"displayName": "Nimbus settlement wallet",
"walletAddress": "0x9f8B4a71Cc0Ed2b3F6a9E7c1D5b8A2f4E6c04C21",
"currency": "USDC_ETH",
"idempotencyKey": "a1b2c3d4-1111-2222-3333-444455556666"
}
}
EOF{
"id": "uspay-z2oaq71hlo7fhvck2xw0nidg",
"counterpartyId": "uspay-z2oaq71hlo7fhvck2xw0nidg",
"createdAt": "2026-09-09T20:39:30Z",
"updatedAt": "2026-09-09T20:39:30Z",
"name": "Nimbus Settlement Ltd",
"displayName": "Nimbus Settlement Ltd",
"email": "treasury@nimbus-settlement.com",
"address": {
"addressLine1": "25 Sir John Rogerson's Quay",
"city": "Dublin",
"stateProvince": "County Dublin",
"postalCode": "D02 XY45",
"countryCode": "IE"
},
"relationshipToUser": "THIRD_PARTY",
"type": "BUSINESS"
}Beneficiaries
Create a Beneficiary
Creates a beneficiary together with its first payout instrument for the authenticated Meridian account. The instrument is either a bank account (BANK_ACCOUNT) or a stablecoin wallet address (BLOCKCHAIN_WALLET); further instruments are attached with POST /v1/beneficiaries/{beneficiaryId}/instruments.
POST
/
v1
/
beneficiaries
curl --request POST \
--url https://sandbox-api.va.meridianpay.com/v1/beneficiaries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"type": "BUSINESS",
"name": "Nimbus Settlement Ltd",
"displayName": "Nimbus Settlement Ltd",
"email": "treasury@nimbus-settlement.com",
"relationshipToUser": "THIRD_PARTY",
"address": {
"addressLine1": "25 Sir John Rogerson's Quay",
"city": "Dublin",
"stateProvince": "County Dublin",
"postalCode": "D02 XY45",
"countryCode": "IE"
},
"instrument": {
"type": "BLOCKCHAIN_WALLET",
"displayName": "Nimbus settlement wallet",
"walletAddress": "0x9f8B4a71Cc0Ed2b3F6a9E7c1D5b8A2f4E6c04C21",
"currency": "USDC_ETH",
"idempotencyKey": "a1b2c3d4-1111-2222-3333-444455556666"
}
}
EOF{
"id": "uspay-z2oaq71hlo7fhvck2xw0nidg",
"counterpartyId": "uspay-z2oaq71hlo7fhvck2xw0nidg",
"createdAt": "2026-09-09T20:39:30Z",
"updatedAt": "2026-09-09T20:39:30Z",
"name": "Nimbus Settlement Ltd",
"displayName": "Nimbus Settlement Ltd",
"email": "treasury@nimbus-settlement.com",
"address": {
"addressLine1": "25 Sir John Rogerson's Quay",
"city": "Dublin",
"stateProvince": "County Dublin",
"postalCode": "D02 XY45",
"countryCode": "IE"
},
"relationshipToUser": "THIRD_PARTY",
"type": "BUSINESS"
}Authorizations
meridian-account-jwtpartner-api-key
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
application/json
Beneficiary identity and first payout instrument
- Create Person Beneficiary Request
- Create Business Beneficiary Request
Create a person beneficiary together with its first instrument
Response
The newly created beneficiary
- Person Beneficiary Response
- Business Beneficiary Response
A person beneficiary