Payment method identifiers
The UUID for each payment method Ozow supports, for the fields that take one.
Build with AI 2 packages
A build package is every page for one task, with the API operations they use. Copy the prompt into a coding assistant, or hand it the package itself: slim links to each page, full inlines all of them in one document.
- Take a paymentEverything needed to take a payment end to end with One API, from credentials through the hosted page to the webhook that confirms it, and the test cases that prove each outcome before you go live.
- Migrate a payin from the Payments API to One APIEverything needed to move an existing redirect payin onto One API, with the legacy guide and its One API counterpart side by side.
Ozow identifies each payment method by a UUIDUUID A 128-bit identifier written as 36 characters, such as 497f6eca-6276-4993-bfeb-53cbbbba6f08. Generated rather than assigned in sequence, so two systems can create identifiers without coordinating.Wikipedia. The same identifier works across the APIs,
under different field names: institutionId on One API, SelectedBankId on the
Payments API.
Send one to take a customer straight to that method, skipping the screen where they choose. Leave the field out and the customer chooses on the Ozow payment page, which is what most integrations do.
Standalone button marks the ones you can put your own button behind, as Choose a checkout experience describes. The rest identify a bank within Pay by BankPay by Bank The payer authorises the payment inside their own banking app or online banking, and the funds move from their bank account. No card is involved and no card details are entered. rather than a method a customer would recognise as its own button.
| Payment method | Identifier | Standalone button |
|---|---|---|
| Absa | 3284 |
Deprecated |
| Absa PayAbsa Pay Absa's own payment method, which the customer authorises in their Absa banking app. It gets its own button at checkout rather than sitting inside the bank list, and it requires Customer Identity Verification.Absa | 8 |
Yes |
| African Bank | 33 |
Yes |
| Bidvest Bank Grow | E022 |
Yes |
| Buy Now Pay Later | 643 |
Yes |
| Capitec PayCapitec Pay Capitec's own payment method. The payer gives a cellphone, account or ID number rather than card details, and approves the payment in the Capitec app, so no card number and no banking login is ever entered at checkout. It gets its own button rather than sitting inside the bank list, and it requires Customer Identity Verification.Capitec | 913999 |
Yes |
| Card | 3 |
Yes |
| Crypto | 43 |
Yes |
| FNB | 4816019 |
Yes |
| FNB Pay | 23 |
Yes |
| GoTyme Bank | 28 |
Deprecated |
| Investec | 4 |
Yes |
| Nedbank | D3889 |
Yes |
| Nedbank Direct EFTNedbank Direct EFT Nedbank's own payment method. Like the other bank APIs it gets its own button at checkout rather than sitting inside the bank list, and it requires Customer Identity Verification.Nedbank | 8 |
Yes |
| PayShap RequestPayShap Request The request side of PayShap. Rather than the payer pushing money, the payee asks for it: the payer receives a request and approves it in their own banking app, and the funds move once they do. Enabled by Ozow on request rather than by default.payshap.co.za | EEC08676-46 |
Yes |
| Standard Bank | AD7 |
Yes |
| Voucher | 42 |
Yes |
Note
Not every identifier is enabled on every account. Pay by Bank is available by default; Capitec Pay, Buy Now Pay Later, card, crypto and PayShap Request are enabled by Ozow on request. Sending an identifier your account is not enabled for will result in an error.
Where these are used
| API | Field | Where |
|---|---|---|
| One API | institution |
POST /, at the top level of the request |
| One API | details. |
POST /, when payment is ozowredirect |
| One API | institution |
Inside a bank account object: a refund's paid, a settlementSettlement Ozow paying the money you have collected into your bank account. Payins arrive at Ozow first and are settled to you on a schedule, so what a customer paid you today and what has been settled to you today are different amounts.'s bank, and a redirectRedirect Sending the payer to the Ozow payment page to complete the payment, and returning them to your site afterwards. The alternative is embedding the checkout in your own page, where the payer never leaves it.'s beneficiary and verified |
| Payments API | Selected |
Redirect to Ozow, on the payment request |
Important
Field names are case sensitive, and a name that differs by a character is a name the API does not recognise. The rejection does not say which field was wrong, so copy the names from the reference page for the operation you are calling rather than retyping them.
Bank availability changes. Banks go down for infrastructure work and updates, and Ozow notifies you where it can, so treat a bank being reachable as something to handle rather than assume.
Last updated