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

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