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

Transaction Status

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

Installment Type Code

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

Notification Match Amount Indicator

0



When Success

mRefNo

AN

18

Reference Number

202305250918303



When Success

payMethod

N

2

Payment Method Code

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




Updated 23 Aug 2024
Did this page help you?
PREVIOUS
Convenience Store - API Checkout
NEXT
E-Wallet - API Checkout
Docs powered by Archbee