E-Wallet - API Checkout
ini digunakan oleh untuk melakukan pengajuan kepada untuk menggunakan .
Deskripsi alur setelah melakukan pesanan:
- mengajukan checkout kepada .
- mengirimkan pengajuan checkout menggunakan Registration kepada .
- mengirimkan response regist kepada .
- mengirimkan kepada .
- mengajukan kepada .
- melakukan generate pesanan.
- menyimpan .
- Pada saat :
- Jika menggunakan OVO, maka akan mengimkan kepada aplikasi terkait untuk melakukan .
- Jika menggunakan lain (selain OVO dan AstraPay), maka akan mengalihkan menuju . Kemudian, harus melakukan login dengan akun terkait sebelum melakukan .
- mengirimkan kepada .
- menerima .
- mengirimkan kepada .
- menerima .
- mengirimkan kepada .
- menerima .
- mengajukan pemeriksaan kepada .
- mengirimkan response dari pemeriksaan kepada .
- menerima akhir.
- mengirimkan konfirmasi pesanan kepada .
Deskripsi alur saat melakukan :
- Jika belum memiliki akun AstraPay:
- request checkout kepada .
- mengirimkan account link request kepada AstraPay.
- AstraPay menerima request dikirim oleh .
- AstraPay mengirimkan response pengalihan URL menuju kepada .
- mengirimkan response pengalihan URL kepada .
- menampilkan pendaftaran kepada .
- melakukan pendaftaran akun.
- mengirimkan pendaftaran akun kepada AstraPay.
- AstraPay melakukan validasi akun.
- AstraPay mengirimkan kepada .
- mengirimkan kepada .
- mengirimkan bahwa akun sudah didaftarkan kepada .
- request checkout kepada .
- mengajukan kepada AstraPay.
- AstraPay melakukan generate .
- AstraPay mengirimkan response redirect URL kepada .
- mengirimkan response redirect URL kepada .
- mengalihkan kepada AstraPay.
- melakukan verifikasi .
- melakukan kepada AstraPay.
- AstraPay melakukan verifikasi .
- AstraPay mengirimkan callback kepada .
- mengirimkan response kepada .
- menampilkan response callback kepada .
- AstraPay mengirimkan kepada .
- menerima .
- mengirimkan kepada .
- menerima .
- request pemeriksaan kepada .
- mengirimkan response kepada .
- menerima akhir.
- memperbarui kepada .
Proses checkout memiliki dua perbedaan alur, yaitu asynchronous dan synchronous. Pada alur asynchronous, perlu memasukkan kredensial untuk masuk ke dalam aplikasi sebelum melakukan . Sementara untuk synchronous, tidak perlu memasukkan kredensial aplikasi terlebih dahulu dan dapat langsung melakukan melalui dikirimkan pada aplikasi .
Perbedaan alur tersebut dapat dilihat pada dua alur di bawah ini.
Deskripsi alur setelah melakukan checkout pesanan:
- requests checkout kepada .
- mengirimkan request checkout menggunakan Registration kepada .
- mengirimkan response Registration kepada .
- request kepada .
- mengajukan kepada dan menyimpan .
- melakukan generate pesanan.
- menyimpan .
- Jika menggunakan lain (selain OVO dan AstraPay), maka akan mengalihkan menuju .
- melakukan login dengan akun terkait sebelum melakukan .
- mengirimkan kepada .
- menerima .
- mengirimkan kepada .
- menerima .
- mengirimkan kepada .
- menerima .
- request pemeriksaan kepada .
- mengirimkan response dari request pemeriksaan kepada .
- menerima terakhir.
- mengirimkan konfirmasi pesanan kepada .
Deskripsi alur setelah melakukan checkout pesanan:
- request checkout kepada .
- mengirimkan request checkout menggunakan Registration kepada .
- mengirimkan response regist kepada .
- mengirimkan kepada .
- mengajukan kepada .
- melakukan generate pesanan.
- menyimpan .
- (OVO) akan mengimkan kepada aplikasi terkait untuk melakukan .
- mengirimkan kepada .
- menerima .
- mengirimkan kepada .
- menerima .
- mengirimkan kepada .
- menerima .
- request pemeriksaan kepada .
- mengirimkan response dari request pemeriksaan kepada .
- menerima akhir.
- mengirimkan konfirmasi pesanan kepada .
Gambar di atas adalah contoh Checkout dengan metode menggunakan Secure Page.
Setelah pengajuan registrasi telah selesai, dapat melanjutkan sampai dengan penyelesaian dengan mengikuti Panduan Bayar E-Wallet.
Catatan untuk ShopeePay dan OVO, silakan berikan pesan peringatan kepada untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada .
API URL | /nicepay/redirect/v2/payment |
|---|---|
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
paymentURL Required | ANS | 14 | URL | https://dev.nicepay.co.id/nicepay/redirect/v2/payment |
tXid Required | AN | 30 | Transaction ID | TNICEEW05100202212201020014087 |
Catatan untuk ShopeePay dan OVO, silakan berikan pesan peringatan kepada untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada .
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | SUCCESS |
tXid | AN | 30 | Transaction ID | IONPAYTEST00202212201351474222 When Success |
referenceNo | ANS | 40 | Order Number | ordNo20221220131215 When Success |
payMethod E-Wallet, Payloan | N | 2 | 05 When Success | |
amt | N | 12 | Transaction Amount | 5000 When Success |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221220 When Success |
transTm | N | 6 | Transaction Time (HH24MISS) | 135201 When Success |
mitraCd Direct Debit, E-Wallet, Payloan | A | 4 | DANA When Success | |
callBackUrl | ANS | 255 | Result URL | https://webhook.site/7bef799f-ebe2-4328-a7b3-6d53deedca27 When Success |
Catatan: Response akan dikirimkan melalui callbackUrl dengan Content-type: application/json dan metode: POST Parameter.
Pada saat Checkout, response dari request melalui hit adalah Callback URL.
Saat Callback diterima callbackUrl , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan CallBack parameter.
