NICEPAY API
...
Checkout API
Registration - API Checkout

Direct Debit - API Checkout

14min

About Direct Debit - API Checkout



This

 uses by

to requests

to

for


using


.



Process Flow


Direct Debit Payment Flow
Direct Debit Payment Flow


Steps description:

  1. The
    
    requests
    
    to
    
    
    .
  2. The
    
    will register
    
    by using Registration
    
    to
    
    .
  3. 
    
    save
    
    regist.
  4. 
    
    redirect
    
    to
    
    
    
    .
  5. The
    
    displays
    
    's
    
    
    to
    
    
    .
  6. The
    
    chooses
    
    
    .
  7. The
    
    input
    
    
    data (Jenius: Cashtag).
  8. The
    
    sends
    
    selected
    
    to
    
    .
  9. 
    
    requests
    
    to
    
    .
  10. 
    
    
    s with
    
    authentication
    
    .
  11. 
    
    sends
    
    authentication to
    
    
    .
  12. The
    
    performs authentication.
  13. The
    
    requests
    
    charge to
    
    .
  14. 
    
    does
    
    
    
    .
  15. 
    
    sends
    
    
    result to
    
    
    .
  16. 
    
    sends push
    
    to
    
    .
  17. 
    
    validates
    
    
    .
  18. 
    
    updates
    
    
    .
  19. 
    
    sends a
    
    to
    
    
    .
  20. The
    
    requests
    
    checking by using Status
    
    to
    
    
    .
  21. 
    
    sends
    
    response
    
    to
    
    
    .
  22. The
    
    receives
    
    final
    
    .
  23. The
    
    sends
    
    confirmation
    
    update to
    
    
    .



NICEPAY Secure Payment Page


Secure Payment Page
Secure Payment Page


The image above is a

 sample with

method using

Secure

Page.

Direct Debit - Secure Payment Page
Direct Debit - Secure Payment Page


After selecting

 method

, you will be redirected to


to select

desired


. Next, you will be redirected to

form

to enter your identity. In

example above, if you choose Jenius

, you will be asked to enter your Cashtag data in

form provided. After completing

form, you can continue



. Then, you can

until



is successful.

Success - Secure Payment Page
Success - Secure Payment Page


The

 of

registration request has been completed. You can continue



until settlement by following

guidelines in

Direct Debit Payment Guide.



API Checkout Transaction Payment



API URL

/nicepay/redirect/v2/payment

Request Method

Redirect-GET

Header

Content-Type: application/Form-UrlEncoded



Request Parameters for Payment



Parameter

Type

Size

Description

Remark

paymentURL

Required

ANS

14



 URL



https://dev.nicepay.co.id/nicepay/redirect/v2/payment

tXid

Required

AN

30

Transaction ID



IONPAYTEST00202203211640309389



Response Parameters (CallbackUrl) - Payment



Parameter

Type

Size

Description

Remark

status

N

1

0

merchantToken

AN

255



 Token

46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa



When Success

goodsNm

Direct Debit, E-Wallet, Payloan

AN

100

Goods Name

Jhon+Doe



When Success

billingNm

Direct Debit, E-Wallet, Payloan

A

100

Billing Name

Jhon+Doe



When Success

referenceNo

ANS

40

Order Number

ORD20230525090536



When Success

mitraCd

Direct Debit, E-Wallet, Payloan

A

4

Mitra Code

JENC



When Success

tXid

AN

30

Transaction ID

TNICECP04100202305250918306465



When Success

amt

N

12

Transaction Amount

5000



When Success

receiptCode

ANS

20

Authorization Number

951527524097



When Success

instmntType

N

2

2



When Success

instmntMon

N

2

Installment Month 1: 1 Month/Full

, if instmntType : null/1 3: 3 Months 6: 6 Months 12: 12 Months

1



When Success

matchCl

N

1

0



When Success

mRefNo

AN

18

Reference Number

202305250918303



When Success

payMethod

N

2

04



When Success

currency

A

3

Currency

IDR



When Success

Note: Response

 will be sent through callBackurl with Content-type: application/json and method: POST Parameter.

Sample Parameter for CallbackUrl API Checkout Payment



On



when

,

response from

request that got hit is a Callback URL.

Url Request
Url Callback
Response Callback




CallBack Handling API Checkout Payment



When Your callback already received callbackUrl, we recommended



to do


verification using

Status Inquiry - API Checkout.

CallBack Handling is necessary to minimize Fraud actions. We strongly recommend

 to verify using callBack parameter.

Callback Handling Flow
Callback Handling Flow

URL CallBack
Response CallBack