Table of content
Overview
The payment-integration service APIs allow NCB to integrate with external partners VNPAY, PAYOO, and NAPAS for checking and paying a wide range of bills and services. Customers can verify their bill details before payment and complete transactions directly via NCB’s channels.
Supported services include:
- Utilities: Electricity, water, television, Internet, landline phone
- Mobile: Postpaid, prepaid top-up
- Insurance and tuition
- Credit card repayment
- ETC (road tolls)
- Airlines (through NAPAS: Vietjet, Vietnam Airlines, Bamboo)
Why use these APIs?
- Comprehensive coverage: One integration for multiple billers and service types.
- Transparency: Customers can always view bill details before paying.
- Seamless processing: Synchronizes status across NCB, intermediaries (VNPAY, PAYOO, NAPAS), and billers.
- Error handling: Supports validation and voiding in case of failed payments.
- Customer convenience: Brings multiple payment services into a single app.
Key features & APIs
Check bill APIs
/vnpay/check-bill– Retrieve billing info for electricity, water, internet, landline, postpaid mobile, and ETC via VNPAY./vnpay/check-bill-kplus– Retrieve subscription details for K+ TV packages via VNPAY./vnpay/check-bill-road– Retrieve billing info for road toll (ETC) services via VNPAY./vnpay/check-bill-cab– Retrieve cable TV billing info via VNPAY./payoo/check-bill– Retrieve billing info via PAYOO for water, internet, landline, insurance, and tuition./napas/check-bill– Retrieve billing info for airline tickets (Vietjet, Vietnam Airlines, Bamboo) via NAPAS.
Pay bill APIs
/vnpay/pay-bill– Pay bills for supported services (except mobile top-up) via VNPAY./vnpay/pay-bill-topup– Mobile top-up payments via VNPAY./payoo/pay-bill– Pay bills via PAYOO for supported services./napas/pay-bill– Pay bills via NAPAS for supported services (e.g., airlines).
