- Circle Mint payins — deliver stablecoin from your Circle Mint balance.
- Borderless payins — on-ramp from fiat; the payer funds a Wire, ACH, or SEPA deposit and Borderless delivers the stablecoin on-chain.
Circle Mint payins
Deliver stablecoin from your Circle Mint balance to a registered recipient wallet.Prerequisites
- Circle Mint enabled for your organization, with provider credentials configured (see dashboard setup)
- A destination wallet on a supported network
Payins:CreateandPayins:Readpermissions- An organization user or service account — delegated end users cannot create payins
1
Register a recipient
: Register payin recipientRegister a wallet’s address as a payin recipient with the provider before delivering funds to it.The registration must be approved on the provider’s side — for Circle Mint, by an administrator in the Mint Console — before payins to that wallet can be created.
Request
Response
2
Wait for the recipient to be approved
: Get payin recipientCheck the recipient’s status until it is Recipient status values:
Active. Pass the provider, walletId, and currency as query parameters.Request
3
Create a payin
: Create payinDeliver stablecoin from your provider balance to the wallet on-chain. The The
currency determines the delivered stablecoin (for example, USD delivers USDC).Request
Response
amount is expressed in currency units (for example, "100.00"), not minimum denomination.4
Track the payin
: Get payin statusPoll the payin to follow its progress. The response carries both the top-level
status and the granular data.executionStatus, along with the delivery transactionHash once the transfer is on chain.Request
Payin statuses
The top-levelstatus values are:
The provider-specific
data.executionStatus (Circle Mint) refines this: Initializing, AwaitingTransfer, Completed, Failed. On failure, data.reason explains why.
Borderless payins
Borderless is a fiat on-ramp: rather than delivering from a stablecoin balance you already hold, the payer funds a fiat deposit (Wire, ACH, or SEPA) and Borderless delivers the stablecoin on-chain to your wallet. The flow is quote-based — lock a rate, create the payin, then hand the payer the deposit instructions Borderless returns.Prerequisites
- A Borderless account with completed KYB, and an account set up in the Borderless dashboard
Payins:CreateandPayins:Readpermissions- An organization user or service account — delegated end users cannot create payins
1
Check the available options
: List payin optionsList the assets Borderless can deliver and the fiat currency, payment-method, and country combinations its active institutions currently cover. Pass
provider=Borderless.Request
2
Register the destination address
: List payin accounts : Register payin account assetList your Borderless accounts and the wallet addresses registered per asset. An account is created in the Borderless dashboard. If the destination wallet’s address is not yet registered for the asset you want delivered, register it — this is required before Borderless can deliver to the wallet.
Request
3
Request a quote
: Request payin quoteRequest an executable quote for the delivery. The response returns one or more quotes, each with a
quoteId, an expiry, and an offer holding the delivered amount (net of fees) and the fees in the fiat currency.Request
4
Create the payin
: Create payinCreate the payin with
provider: Borderless and the quoteId to lock the rate. The response’s data carries the Borderless deposit instructions — the details the payer uses to fund the fiat deposit.Request
5
Fund the deposit and track
: Get payin statusThe payer settles the fiat deposit using the returned instructions. Poll the payin to follow its progress:
data.executionStatus reflects the Borderless steps, and the delivery transactionHash appears once the stablecoin is delivered on-chain.Request
Check provider balances
: List payin balances Retrieve your available balance at the provider, one entry per currency. Pass theprovider (CircleMint or Borderless) as a query parameter.
Request
Response
List payins
: List payins List your payins to reconcile deliveries:Request