NICEPAY API
...
Checkout API
Payment - API Checkout

Payloan - API Checkout

15min

About Payloan - API Checkout



This  uses by s to requests  to  for    using  .



Process Flow


Payloan Payment Flow
Payloan Payment Flow


Description of  procedures with :

  1. The  requests  to  .
  2. The  sends Registration  to .
  3. In  Registration :
    • If using Akulaku:
      •  will request   to Akulaku as   .
      • Akulaku generates .
      • Akulaku sends  data response to .
      •  will send  capture of   Regist response to  .
    • If using Kredivo/Indodana:
      •  will save  Order Regist.
      •  will send  Order Regist response.
  4. The  sends    to .
  5. Then in   :
    • If using Akulaku:
      •  will redirect   to  Akulaku .
      • The  login to  account.
      • The  confirms   to Akulaku as   .
      • Akulaku validates  .
      • Akulaku redirects   using callbackUrl.
    • If using Kredivo/Indodana:
      •  requests  to  .
      •   s with   .
      •   sends  response and redirects to    .
      • The  confirms   to  .
      •   sends OTP to  .
      • The  inputs  OTP to   .
      •   validates  OTP.
      •   confirms  result  to  .
  6. In  Notification :
    • If using Akulaku:
      • Akulaku as   sends push capture  to .
      •  saves  .
      •  sends  capture of  update  to  .
      • The  displays  response to  .
    • If using Kredivo/Indodana:
      •   sends  push  to .
      •  validates  received .
      •  requests  confirmation.
      •   confirms   .
      •   sends  confirmation data to .
      •  sends  confirmation result.
  7. If   used is Akulaku,   can confirms   receipt.
    • The  sends  receipt confirmation to  .
    • The  requests  receipt confirmation to .
    •  requests   of  receipt confirmation to Akulaku.
    • Akulaku s   receipt confirmation .
    • Akulaku sends  data response to .
    •  sends  data response to  .
    • The  displays data results to  .
  8. The  sends  request for  checking  by using Status  to .
  9.  sends  response of  checking  to  .
  10. The  receives  final .
  11. The  sends   confirmation to  .



NICEPAY Secure Payment Page


Secure Payment Page
Secure Payment Page


The image above is a   sample with   method using  Secure  Page.

Success - Secure Payment Page
Success - Secure Payment Page


After   of  registration request completes, you can continue    until settlement by following  guidelines in Payloan 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



The following are Request Parameter lists for    on  .

Note for , please give a warning message for   to open by mobile devices for   better user experience.

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



PAYLOANTES00202212201645434449



Response Parameters (CallbackUrl) - Payment



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

Parameter

Type

Size

Description

Example / Remark

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

A

255

Issuing  Name

When Success

acquBankNm

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

 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 , if 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



On   in , theresponse from  request that get hit is  Callback URL.

Url Request
Response Callback
Url 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 very important to minimize  Fraud act, we highly recommend   to do  verification using callBack parameter.

Callback Handling Flow
Callback Handling Flow

URL CallBack
Response CallBack