Transfers API

Transfers move funds from your Meridian platform balance to a connected account. Use transfers in marketplace and platform scenarios to pay out sellers or service providers.

Create a Transfer

POST /v1/transfers

Parameter	Type	Description
amount required	integer	Amount in cents to transfer.
currency required	string	Three-letter ISO currency code.
destination required	string	ID of the connected account to receive the transfer.
source_transaction	string	Charge ID. Funds will be drawn from that specific charge's balance.
description	string	Internal description.

curl https://api.meridian.dev/v1/transfers \
  -u sk_test_4eC39HqL...: \
  -d amount=7000 \
  -d currency=usd \
  -d destination=acct_ConnectedAccountId \
  -d source_transaction=ch_ChargeId

const transfer = await meridian.transfers.create({
  amount: 7000,
  currency: 'usd',
  destination: 'acct_ConnectedAccountId',
  source_transaction: 'ch_ChargeId',
});

Retrieve a Transfer

GET /v1/transfers/:id

List all Transfers

GET /v1/transfers

Filter by destination account or created date range.

Reverse a Transfer

POST /v1/transfers/:id/reversals

Reverses all or part of a transfer:

curl -X POST https://api.meridian.dev/v1/transfers/tr_TransferId/reversals \
  -u sk_test_4eC39HqL...: \
  -d amount=3500