Hosted Payment
Overview
Hosted Payment is a Finpay-hosted checkout page. You redirect the customer to Finpay to choose a payment method and complete payment. Use this when you want a fast integration with minimal checkout UI work.
When to use Hosted Payment
Hosted Payment is a good fit when you:
Want to go live quickly.
Prefer a Finpay-managed payment UI.
Need one flow for multiple payment channels.
Want Finpay to handle channel-specific payment channel instructions.
Consider Core API (Host-to-Host) when you need full control of the checkout UI.
Customer experience
Customer starts checkout in your app or website.
You redirect the customer to the Finpay hosted payment page (URL).
Customer selects a payment method on the Finpay page.
Customer completes payment using the chosen channel.
Finpay returns the customer to your site/app (redirect).
You confirm the final result using the transaction status.
Always treat the redirect as a customer navigation event, not a final payment confirmation. Use transaction status for reconciliation.
Supported payment methods
Payment methods depend on your merchant profile and configuration.
See the full list in Payment Channels.
Common pitfalls
Assuming redirect = paid. Redirect is not a final confirmation.
Not handling pending states. Some channels confirm instantly, others can take time.
Not handling expiry. Unpaid transactions can expire based on channel rules.
Not showing a clear “payment in progress” state after redirect back to your site/app.
If you need exact redirect parameters, expiry behavior, or status mapping, align with Finpay for your environment configuration.
Last updated

