Payment Integration
Supported providers
| Provider | Regions | Type |
|---|---|---|
| Stripe | Global | Card, SEPA, Link |
| Toss Payments | KR | Card, Bank transfer |
| KakaoPay | KR | Mobile wallet |
| GrabPay | SG, MY, PH | Mobile wallet |
| Xendit | ID, PH | Bank transfer, E-wallet |
Provider selection
The billing UI automatically presents regionally appropriate payment options based on the tenant’s home region. No client-side logic is required.
Webhook verification
All payment provider webhooks are verified server-side before any fulfilment action. The gateway signs and forwards verified events to your internal webhook endpoint.
Adding a payment method (API)
curl -X POST $API_URL/v1/billing/payment-methods \ -H "Authorization: Bearer $API_KEY" \ -d '{"provider": "toss", "tokenId": "<toss-token>"}'