Hosted payment page

Overview

The Hosted payment page (HPP) is the simplest Centrobill integration method. All payments are processed on the gateway's side through a Centrobill-hosted webpage, which displays payment methods relevant to the customer's geographical location. The payment result is then sent back to the merchant.

How it works

Your server uses the Gateway API to generate a unique, one-time URL to the gateway's payment form. You redirect the customer to that URL to complete the payment. See the Hosted Payment Page API reference for the full request specification.

Payment flows

Hosted checkout page

Use Centrobill's hosted page for a full asynchronous checkout. This method simplifies compliance and security by handling all payment data through Centrobill's secure page. Generate the payment page URL via the API by specifying the required payment and customer details.

See the Generate URL to payment page API reference.

Synchronous 1-click payments

Use 1-click payments to charge returning customers without redirecting them to the payment page. This synchronous method requires paymentSource.type set to consumer or paymentAccountId.

See the Synchronous pay API reference.

Supported payment types

The HPP integration supports alternative payment methods — including SEPA, iDEAL, Onlinebanking, PIX, and UPI — as well as card processing.

One-time payments

Use one-time payments for single purchases or services.

Recurring subscriptions

Manage subscriptions with automated rebills and retries, handled by Centrobill if set up with initial recurring information. See Set up price information for details on configuring one-time and recurring payment schedules.

Reconciliation

IPNs (Instant Payment Notifications)

Centrobill sends an IPN to your configured ipnUrl for each transaction event, including initial sales and subscription rebills. Your server must respond with HTTP 200 to acknowledge receipt. See Process IPN for details on handling IPN payloads.

Data polling

If an IPN is undelivered, or for chargebacks, refunds, and other transaction discrepancies, you can poll transaction data directly using the Feed API.