Circle APIs Documentation

Learn how to integrate with Circle APIs to accept traditional and stablecoin payments, embed digital wallets into your product or service, or power your internet marketplace.

Supported Currencies

Card Payments

When it comes to a card payment, there are 3 currencies that play a role.

  • The end user's card currency - This is the native currency of the end user's card.
  • The payment (or charge) currency - This is the currency in which the payment being taken from the end user is denominated in (also called the "presentment currency").
  • The settlement currency - This is the currency that payments get settled in.

📘

Card Payments Supported Currencies

  • End user's card currency - Any
  • Payment (or charge) currency - USD
  • Settlement currency - USD/USDC

Because the Circle Payments API always settles in USDC, the settlement currency is always USD. That way, fiat funds being settled can be seamlessly tokenized 1:1 into USDC.

For similar reasons, Circle chooses to define the payment currency as USD for all payments that settle in USDC. That way, when you specify a payment amount on an API call, you do so in USD knowing that you will eventually receive that amount in USDC settlement (minus processing fees).

As a consequence of the above, your end users will see charges on their card statements denominated in USD. Most cards around the world are capable of supporting USD denominated charges.

Foreign Transaction Fees

🚧

Foreign transaction fees - Note 1

Card payments initiated via Circle Payments API are denominated in USD. When the end user's card currency is not USD, their card issuer might decide to charge them foreign transaction fees.

🚧

Foreign transaction fees - Note 2

At present, Circle originates Circle Payments API card charges as a merchant registered out of Europe (United Kingdom). When the charge country is not the same as the end user's card issuing country, the card issuer might deem the transaction to be international and decide to charge the end user foreign transaction fees.

Wire Transfer Payments & Payouts

When it comes to a wire transfer, there are 3 currencies that play a role.

  • The end user's bank account currency - This is the native currency of the end user's bank account.
  • The transfer currency - This is the currency in which the wire transfer is denominated in on the end user's side.
  • The settlement currency - This is the currency that incoming wire transfers get settled in.

Because the Circle Payments API always settles in USDC, the settlement currency is always USD. That way, fiat funds being settled can be seamlessly tokenized 1:1 into USDC. In other words, Circle only accepts USD denominated funds arriving via wire transfer.

The end user will typically denominate the wire transfer in USD on their side. If the wire transfer is denominated in another currency, corresponding or receiving banks might charge a fee for converting the transfer into USD along the way.

📘

Wire Payments Supported Currencies

  • End user's bank account currency - Any
  • Transfer currency - Any
  • Settlement currency - USD/USDC

🚧

Currency Conversion Fees

When the end user's bank account currency is not USD, their bank might charge them fees when they initiate a USD-denominated wire transfer.

The Circle Payments API will always initiate a wire payout denominated in USD - this ensures the USDC amount used for payout is matched 1:1 with the outgoing wire transfer (minus processing fees). When the end user's bank account currency is not USD, their bank might charge them currency conversion fees.

📘

Wire Payouts Supported Currencies

  • End user's bank account currency - Any
  • Transfer currency - USD
  • Settlement currency - USD/USDC

🚧

Currency Conversion Fees

When the end user's bank account currency is not USD, their bank might charge them currency conversion fees when receiving a wire transfer.

ACH Payments & Payouts 🔜

Note that ACH payments and payouts are not yet available via the Circle Payments API, but they are coming soon.

Once available, the Circle Payments API will only support ACH transfers from / to bank accounts domiciled in the United States.

The only supported currency for ACH payments and payouts is USD.

📘

ACH Payments & Payouts Supported Currencies

  • End user's bank account currency - USD
  • Settlement currency - USD/USDC

Updated 3 months ago


Supported Currencies


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.