NICEPAY API
...
Checkout API
Payment - 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