Marketplace Transfers

Marketplace transfers move custodial funds from your marketplace balance to one of your sub-merchants — for bonuses, refund top-ups, corrections, or manual revenue sharing. Only the marketplace → sub-merchant direction is supported.

Endpoints

All routes use your marketplace API key, without X-On-Behalf-Of:

Action	Endpoint
Create a transfer	`POST /api/connect/transfers`
Get a transfer	`GET /api/connect/transfers/{transferId}`
List transfers	`GET /api/connect/transfers`

Creating a Transfer

curl -X POST https://api.inflowpay.xyz/api/connect/transfers \
  -H "X-Inflow-Api-Key: your_marketplace_key" \
  -H "Content-Type: application/json" \
  -d '{
    "originId": "usr_marketplace",
    "destinationId": "usr_submerchant",
    "amountInCents": 5000,
    "currency": "USDC",
    "idempotencyKey": "transfer-2026-06-12-001",
    "description": "Weekly bonus for seller Alpha"
  }'

Fields

Field	Type	Required	Description
`originId`	string	Yes	User id of the account to debit — must be your own marketplace account
`destinationId`	string	Yes	User id of the account to credit — must be a sub-merchant you own
`amountInCents`	integer (≥ 1)	Yes	Amount in minor units (cents)
`currency`	`USDC` \| `EURC`	No	Stablecoin to move (default: `USDC`)
`idempotencyKey`	string	No	Re-sending the same key returns the existing transfer instead of creating a duplicate — recommended for retries
`description`	string	No	Free-form description stored on the transfer
`metadata`	object	No	Arbitrary metadata attached to the transfer

Use an idempotencyKey on every transfer you might retry (network errors, job re-runs). Without it, a retried request creates a second transfer.

Tracking Transfers

# One transfer
curl https://api.inflowpay.xyz/api/connect/transfers/{transferId} \
  -H "X-Inflow-Api-Key: your_marketplace_key"

# All transfers (paginated, filterable)
curl "https://api.inflowpay.xyz/api/connect/transfers?page=1&limit=20" \
  -H "X-Inflow-Api-Key: your_marketplace_key"

Fees and Payouts — how marketplace fees are collected in the other direction (sub-merchant → marketplace).
Acting on Behalf Of — spending or paying out a sub-merchant's balance once credited.

Endpoints

Creating a Transfer

Fields

Tracking Transfers

Related