NICEPAY API
...
Checkout API
Payment - API Checkout

Payloan - API Checkout

15min

Tentang Payloan - API Checkout



 ini digunakan oleh  untuk melakukan pengajuan  kepada  untuk   menggunakan  .



Alur Proses


Alur Pembayaran Paylate
Alur Pembayaran Paylate


Deskripsi langkah  dengan :

  1.  request checkout kepada .
  2.  mengirimkan  Registration kepada .
  3. Pada bagian Registration;
    • Jika menggunakan Akulaku:
      •  akan request pesanan kepada Akulaku selaku  .
      • Akulaku akan generate pesanan.
      • Akulaku mengirimkan response data kepada .
      •  akan mengirimkan capture response  Regist kepada .
    • Jika menggunakan Kredivo/Indodana:
      •  akan menyimpan  regist.
      •  akan mengirimkan response  regist.
  4.  mengirimkan   kepada .
  5. Kemudian pada bagian Payment;
    • Jika menggunakan Akulaku:
      •  mengarahkan  kepada  Akulaku.
      •  melakukan login akun.
      •  melakukan konfirmasi  kepada Akulaku selaku  .
      • Akulaku melakukan validasi .
      • Akulaku mengalihkan  dengan callbackUrl.
    • Jika menggunakan Kredivo/Indodana:
      •  request checkout kepada  .
      •   melakukan  .
      •   mengirim response dan mengalihkan ke  milik  .
      •  melakukan konfirmasi  kepada  .
      •   mengirimkan OTP kepada .
      •  memasukkan OTP kepada  .
      •   melakukan validasi OTP.
      •   melakukan konfirmasi hasil pesanan kepada .
  6. Pada bagian Notification;
    • Jika menggunakan Akulaku:
      • Akulaku selaku   mengirimkan push capture notif kepada .
      •  menyimpan .
      •  mengirimkan capture update notification kepada .
      •  menampilkan response kepada .
    • Jika menggunakan Kredivo/Indodana:
      •   mengirimkan push notification kepada .
      •  melakukan validasi terhadap   diterima.
      •  mengajukan konfirmasi pesanan.
      •   melakukan konfirmasi  pesanan.
      •   mengirim data konfirmasi pesanan kepada .
      •  mengirimkan hasil konfirmasi pesanan.
  7. Jika    digunakan adalah Akulaku,  dapat melakukan konfirmasi bukti :
    •  mengirimkan konfirmasi bukti  kepada .
    •  mengajukan konfirmasi bukti  kepada .
    •  mengajukan  konfirmasi bukti  kepada Akulaku.
    • Akulaku melakukan  konfirmasi bukti .
    • Akulaku mengirim response data kepada .
    •  mengirim response data kepada .
    •  menampilkan hasil data kepada .
  8.  mengajukan pemeriksaan  menggunakan  Status kepada .
  9.  mengirimkan response pemeriksaan .
  10.  menerima  terakhir.
  11.  mengirimkan  konfirmasi kepada .



NICEPAY Secure Payment Page


Secure Payment Page
Secure Payment Page


Gambar di atas adalah contoh   dengan metode  menggunakan  Secure  Page.

Success - Secure Payment Page
Success - Secure Payment Page


Setelah  request registrasi  selesai,  dapat melanjutkan   sampai dengan penyelesaian dengan mengikuti panduan pada  Panduan Bayar Payloan.



API Checkout Transaction Payment



API URL

/nicepay/redirect/v2/payment

Request Method

Redirect-GET

Header

Content-Type: application/Form-UrlEncoded



Request Parameters for Payment



Berikut adalah daftar Request Parameter untuk    pada  .

Catatan untuk , silakan berikan pesan peringatan kepada  untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada .

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



PAYLOANTES00202212201645434449



Response Parameters (CallbackUrl) - Payment



Catatan: Response  akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

0000

resultMsg

AN

255

Result Message: Error Code

SUCCESS

tXid

AN

30

Transaction ID

PAYLOANTES00202212201645434449



When Success

referenceNo

ANS

40

Order Number

ORD20221220161200



When Success

payMethod

E-Wallet, Payloan

N

2

06



When Success

amt

N

12

Transaction Amount

10000



When Success

currency

E-Wallet, Payloan

A

3

Currency

IDR



When Success

goodsNm

E-Wallet, Payloan

AN

100

Goods Name

John+Doe



When Success

billingNm

E-Wallet, Payloan

A

100

Billing Name

John+Doe



When Success

transDt

N

8

Transaction Date (YYYYMMDD)

20221220



When Success

transTm

N

6

Transaction Time (HH24MISS)

164543



When Success

description

AN

100

Transaction Description

Test+Transaction+Nicepay



When Success

authNo

Only CC

N

10

Approval Number

When Success

issuBankCd

Only CC

A

4



When Success

acquBankCd

Only CC

A

4

When Success

issuBankNm

Only CC

A

255

Issuing  Name

When Success

acquBankNm

Only CC

A

255

Acquiring  Name

When Success

cardNo

Only CC

ANS

20

Card Number with Masking

When Success

recurringToken

Only CC (Additional)

AN

255

Recurring Token

When Success

preauthToken

AN

255

Pre-Auth Token

null



When Success

ccTransType

AN

2

Credit Card Transaction Type:

1: Normal

2: Recurring

3: Pre-Auth

4: Capture

When Success

mitraCd

Direct Debit, E-Wallet, Payloan

A

4

Mitra Code

KDVI



When Success

receiptCode

ANS

20

Authorization Number

When Success

mRefNo

AN

18

Reference Number

When Success

cardExpYymm

N

4

Card Expiry (YYMM)

When Success

instmntType

N

2

When Success

instmntMon

N

2

Installment Month 1: 1 Month/Full , jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months

When Success

timeStamp

N

14

 Request Timestamp

When Success

merchantToken

AN

255

 Token

When Success



Sample Parameter for CallbackUrl API Checkout Payment



Pada  saat Checkout, response dari request  di-hit adalah Callback URL

Url Request
Response Callback
Url Callback




CallBack Handling API Checkout Payment



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.

Alur CallBack Handling
Alur CallBack Handling

URL CallBack
Response CallBack