Direct API integration
Direct API integration
Build your own checkout on the Kashier API
Direct API integration gives you full control over the payment experience: your own card form, token-based repeat payments, 3D Secure handling, wallets, installments, and kiosk payments.
PCI DSS responsibility
Collecting card data on your own pages changes your PCI DSS scope compared to the hosted checkout. Review your compliance requirements before choosing this path.
The core path
These three pages are the integration. Work through them in order — none of them is optional, and a card payment will not complete if you skip one:
- Request hashing — every request is signed, and the signature is generated on your backend with your Payment API Key. Read this first; an unsigned or wrongly-signed request fails before anything else you build gets exercised.
- Customized card form — collect the card and submit the payment.
- 3D Secure handling — handle the authentication challenge and verify the result. Most Egyptian card transactions are challenged, so treat this as part of the happy path rather than an edge case.
Optional add-ons
Add these only if your flow needs them:
- Saved cards — pay with token, retrieve tokens, and delete token.
- Other payment methods — wallet payments and kiosk & cash payments (Basata, Aman, Cash).
- Installment plans — bank installments and standalone BNPL providers (valU, Octo, Souhoola, Contact, Mogo, Tru, Forsa).
See rate limits for the request-per-minute cap on the payment API.