Toss Pay

Toss Pay Availability: This feature is being rolled out in phases and may only be available for some eligible users.

Toss Pay gives South Korean buyers a fast, secure, and local way to complete purchases using the Toss app.

FastSpring offers Toss Pay as a payment method for South Korean buyers purchasing in South Korean won (KRW). Depending on the device, buyers either scan a QR code (on desktop) or are redirected to the Toss app (on mobile) to confirm payment.

The sections below explain how to use Toss Pay, understand the buyer flow, and review webhooks and common questions. Select a section or use the TOC on the right to jump ahead.

Prerequisites

Requirements to use Toss Pay

Customer experience

See the buyer payment flow

Refunds and returns

How refunds are processed

Webhooks

Fields included in order.completed

FAQs

Answers to common questions

Prerequisites

Toss Pay has the following requirements:

The buyer must purchase from South Korea and use KRW as the transaction currency.
The buyer must have the Toss app installed and set up on their device.
Toss Pay supports a maximum limit of 2,000,000 KRW per transaction.

Customer experience

Toss Pay offers two distinct checkout experiences, depending on whether the buyer is using a desktop or a mobile device.

Desktop experience

Buyers complete the payment on a desktop by scanning a QR code with the Toss app.

The buyer selects Toss Pay as their payment method during checkout.
FastSpring displays a unique QR code with payment details.
The buyer scans the QR code using their Toss app.
After the buyer confirms payment in the Toss app, the FastSpring checkout automatically updates and displays a success message.

Mobile experience

Buyers complete the payment entirely inside the Toss app on their mobile device before returning to your FastSpring confirmation page.

The buyer selects Toss Pay as their payment method during checkout.
The buyer is redirected to the Toss app, where they review and authorize the payment.
After confirming payment, the Toss app returns the buyer to a FastSpring confirmation page.

Refunds and returns

Refunds for Toss Pay transactions behave the same as other FastSpring refunds. FastSpring automatically returns the refunded amount to the buyer’s Toss Pay account. No special configuration is required to process Toss Pay refunds.

Webhooks

FastSpring includes the following field in the order.completed webhook payload when an order is completed with Toss Pay:

"payment": {
  "type": "tosspay"
}

For more information on the order.completed webhook, see the Successful Orders documentation.

FAQs

Can Toss Pay be used for subscription purchases?

No. Toss Pay supports only perpetual purchases and manual recurring transactions.

Is Toss Pay enabled by default?

During the BETA period, availability may vary. After BETA, Toss Pay will be automatically enabled for all FastSpring sellers.

Does Toss Pay support multiple currencies?

No. Toss Pay supports purchases made in KRW only.

Is Toss Pay a real-time payment method?

Yes. Buyers complete authentication directly inside the Toss Pay app, and FastSpring updates the checkout once the payment is confirmed.