The page your customer lands on
Every hosted checkout page carries the same frame, whatever the payment method:- Your name and logo at the top left, so the customer can see who they are paying.
- A language switcher at the top right, offering the languages relevant to the currency (for example, English and 繁體中文 for HKD, English and Swahili for KES, English and Setswana for BWP), plus a translate control.
- Continue on your phone: moves the payment to the customer’s mobile device, which matters for QR codes and mobile money prompts that need a banking or wallet app.
- The amount, displayed prominently in the payment currency.
Form-based methods (card and bank details)
Card payments and methods that need customer identification show a form. Typical fields are first and last name, email, phone number with a country dial code preselected for the currency, and billing address, city, state, postal code, and country. Some methods also ask for a customer type (individual or organisation), an account number, or a date of birth. The customer completes the form and selects Next to continue to payment.Address autocomplete
For methods that require an address, the address field suggests matching addresses as the customer types and validates the result. The customer picks their address from the dropdown rather than typing it out in full, which cuts down on typing errors and on payments failing verification.Instruction-based methods (bank transfer, QR, and mobile money)
Bank transfer, QR, and mobile money methods do not take payment on the page. Instead they display what the customer needs in order to pay from their own bank or wallet, together with:- The amount, with a Copy button.
- Expiry: the time by which the payment must be completed.
- Transaction ID: the reference for the payment, useful if the customer needs support.
- I have paid: the button the customer selects once they have sent the payment.
- See Instructions: opens fuller instructions for that method.
- Bank transfer (PayID)
- QR code
- Mobile money
The page shows the PayID to pay to, with a Copy button, and the exact amount to send, also copyable.Directly beneath the amount is an alert reminding the customer to enter the amount accurately so the payment can be processed without delays.
The Attention panel
Instruction-based methods carry an ATTENTION panel beside the payment details, styled in blue with a matching information icon. It lists the conditions that decide whether the payment succeeds, and its content is specific to the method and country, covering which networks are supported, how quickly the customer must respond to a prompt, whether they need to keep the page open, and how long processing can take. Common points across methods include:- Respond promptly to any OTP, PIN, or push prompt; a slow response causes the payment to time out.
- Make sure the wallet or account has sufficient balance before starting.
- Do not close or refresh the page until the payment is complete and I have paid has been selected.
- Some methods can take up to 24 hours to reflect, depending on the bank or wallet.
- If the amount or details are incorrect, the transaction may not be recognised.
Read the Attention panel for the methods you enable and reflect the same points in your own order-confirmation messaging. Most failed instruction-based payments come from a customer ignoring a prompt or closing the page early, both of which the panel warns against.