NICEPAY API
...
Payment API
API E-Wallet

Payment - API E-Wallet

12min

Tentang API E-Wallet Payment



Melalui , menawarkan kemudahan lintas aplikasi (Jump App) untuk . Notifikasi akan dikirimkan ke secara real-time sesaat setelah menyelesaikan .

  •  kunjungi Alur Pembayaran E-Wallet untuk mengetahui perbedaan alur secara umum dengan AstraPay.
  •  kunjungi E-Wallet untuk mempelajari umum mengenai .



API E-Wallet Payment



 bertujuan supaya mengaktifkan pada , sehingga dapat melakukan menggunakan dengan . Tahapan ini bertujuan untuk melakukan dari dengan dari .

API URL

/nicepay/direct/v2/payment

Request Method

POP UP, Redirect, Submit

Description

Performs Request to

Merchant Token

SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)

Request Format

application/x-www-form-urlencoded

Proses hanya dapat dijalankan setelah melalui registrasi, silakan pelajari lebih lengkap tentang registrasi pada Registration - API E-Wallet.



Request Parameter for E-Wallet Payment



Berikut ini adalah daftar untuk melakukan pengajuan registrasi . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari .

Catatan tambahan untuk ShopeePay, dalam rangka menghasilkan pengalaman Pengguna lebih baik pada , silakan berikan pesan peringatan (warning message) ke untuk mengakses melalui perangkat ponsel.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20221208065959

tXid

Required

AN

30

Transaction ID

IONPAYTEST05202212081111197444

merchantToken

Required

AN

255

 Token



324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f

callBackUrl

Required

AN

255

Result Page

https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp

returnJsonFormat

 Required for ShopeePay 

AN

100

If value is 1, then it will return ShopeePay link.

If value is empty/0, then it will redirect to other HTML Page.

1: return redirectUrlApp and/or redirectUrlHttp

empty/0 : return HTML to redirect

 dapat mengikuti panduan dan ShopeePay pada Integrasi & Testing E-Wallet.



CallBack Handling E-Wallet



Setelah melakukan request , response didapatkan dari adalah berupa Callback.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

14

Result Code

0000

resultMsg

AN

225

Result Message: Error Code

Success

tXid

AN

30

Transaction ID



IONPAYTEST05202406260930529202

referenceNo

ANS

40

's Reference Number

20240626093051

payMethod 

N

2

05

amt

N

12

Amount

10000

transDt

N

8

Transaction Date (YYYYMMDD)

20240626

transTm

N

6

Transaction Date (HH24MISS)

093052

mitraCd

AN

4

Mitra Code

ESHP

callBackUrl

ANS

500

 result forward URL (on browser)

https://merchant.co.id/nicepay-callback

Ketika Callback diterima callbackurl , merekomendasikan untuk melakukan verifikasi dengan menggunakan Status Inquiry - API E-Wallet.

CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. sangat merekomendasikan untuk melakukan verifikasi menggunakan CallBack Handling.

URL CallBack




Response Parameter for E-Wallet Payment



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

Result Code

0000

resultMsg

AN

255

Result M essage: Error Code

Success

tXid

AN

30

Transaction ID

IONPAYTEST05202406260930529202

referenceNo

ANS

40

's Reference Number

20240626093051

payMethod 

N

2

05

amt

N

12

Amount

10000

transDt

N

8

Transaction Date (YYYYMMDD)

20240626

transTm

N

6

Transaction Date (HH24MISS)

093052

mitraCd

AN

4

Mitra Code

ESHP

paymentExpDt

N

8

 Expiry Date (YYYYMMDD)

20240626

paymentExpTm

N

6

 Expiry Time (HH24MISS)

093530

redirectUrlHttp

AN

100

Returns a universal link redirecting users to .

https://pay.uat.airpay.co.id/h5pay/example

redirectUrlApp

AN

100

Returns a URL redirecting users to mobile apps.

For ShopeePay, this value will be deprecated

redirectToken



AN

2000



Used only for LinkAja

Sample JSON for E-Wallet Payment


Form-Urlencode Request
Sample Response