Developer Docs

Create an internal Connect transfer

Moves custodial funds from the authenticated marketplace to one of its sub-merchants. Only the MARKETPLACE → SUB_MERCHANT direction is allowed: originId MUST be the authenticated marketplace and destinationId MUST be a sub-merchant it owns. The amount is debited from the marketplace custodial wallet and credited to the sub-merchant custodial wallet on Base.

Privy-custodial origins settle synchronously (CONFIRMED). Bridge-custodial origins are submitted asynchronously (PROCESSING) and confirmed later via webhook. Provide an idempotencyKey to safely retry without double-spending.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

User id of the account to debit. MUST be the authenticated marketplace account.

string
required

User id of the account to credit. MUST be a sub-merchant owned by the authenticated marketplace.

number
required
≥ 1

Amount to transfer, in minor units (cents). Must be a positive integer.

string
enum
Defaults to USDC

Stablecoin to move. Defaults to USDC.

Allowed:
string
length ≤ 255

Caller-supplied idempotency key. Re-sending the same key returns the existing transfer instead of creating a duplicate.

string
length ≤ 512

Free-form description stored on the transfer record.

metadata
object

Arbitrary metadata attached to the transfer.

Response

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json