Accept payments in multiple currencies

Stripe can charge the currency of an ERPNext transaction even when the company's accounting currency is different.

Collect a foreign-currency payment

Confirm that the integration, Stripe account, and chosen payment method support the transaction currency. Configure the currency and exchange rate in ERPNext before submitting the source transaction, and review Stripe's settlement and conversion fees.

1. Create a Sales Invoice in the customer's transaction currency.
2. Confirm its conversion rate and submit it.
3. Create a Payment Request from the Sales Invoice.
4. Confirm that the Payment Request currency and amount match the Sales Invoice.
5. Select the Stripe Payment Gateway Account and submit the request.
6. Send the Payment URL to the customer.

Collecting a foreign-currency payment through Stripe

How ERPNext records the payment

Stripe charges the customer in the Payment Request currency. ERPNext creates the Payment Entry using the transaction amount and the reference document's exchange rate where ERPNext requires a company-currency amount.

The amount deposited by Stripe can differ from the ERPNext receivable amount because Stripe fees and Stripe's settlement conversion are separate from the customer payment. Reconcile the Stripe payout and fees through your normal accounting process.

Verify the payment

1. Confirm that Stripe charged the expected amount and currency.
2. Confirm that the ERPNext Payment Entry uses the correct paid and received currencies.
3. Confirm the exchange rate and allocated amount against the Sales Invoice.
4. Investigate any residual outstanding balance instead of assuming that every difference is normal rounding.

Expected result

The customer's payment is allocated to the foreign-currency transaction, and the accounting amounts follow the exchange rate stored on the ERPNext document.

Troubleshooting

• If Checkout does not offer the expected payment method, confirm that the method supports the account country, customer location, currency, amount, and checkout mode.
• If the Payment Entry uses an unexpected currency or amount, compare it with the Payment Request, Sales Invoice, and Stripe Payment Intent.
• If an unexplained balance remains, verify the source document's exchange rate and allocation. Reconcile Stripe payout conversion and fees separately from the customer payment.