Website logo
Navigate through spaces
⌘K
Getting Started
NICEPAY API
Payment
Checkout
Payout
Messaging
SMS
Payment Link
Business Operation
NICEHub
Merchant Back Office
Security
Release Information
Docs powered by Archbee
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

Result Code

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

Payment Method Code

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

Issuing Bank Code

When Success

acquBankCd

Only CC

A

4

Acquiring Bank Code

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

Credit Card 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

Installment Type Code

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
1https://merchant.com/api/callBackUrl




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
1resultCd=0000 2resultMsg=SUCCESS 3tXid=PAYLOANTES00202212201645434449 4referenceNo=ORD20221220161200 5payMethod=06 6amt=10000 7transDt=20221220 8transTm=164543 9description=Test+Transaction+Nicepay 10authNo= 11issuBankCd= 12acquBankCd= 13cardNo= 14receiptCode= 15mitraCd=KDVI 16recurringToken= 17preauthToken= 18currency=IDR 19goodsNm=John+Doe 20billingNm=John+Doe 21ccTransType= 22mRefNo= 23instmntType= 24instmntMon= 25cardExpYymm= 26issuBankNm= 27acquBankNm= 28timeStamp= 29merchantToken=




Updated 23 Aug 2024
Did this page help you?
PREVIOUS
E-Wallet - API Checkout
NEXT
QRIS - API Checkout
Docs powered by Archbee
TABLE OF CONTENTS
About Payloan - API Checkout
Process Flow
NICEPAY Secure Payment Page
API Checkout Transaction Payment
Request Parameters for Payment
Response Parameters (CallbackUrl) - Payment
Sample Parameter for CallbackUrl API Checkout Payment
CallBack Handling API Checkout Payment
Docs powered by Archbee
Copyright © NICEPAY Indonesia All Right Reserved.
Terms and Conditions

Welcome to NICEPAY DOCS

By accessing this site, you are agree with the applicable terms and conditions.

Bahasa Indonesia

  Bank Indonesia already release API Standard relate to the Payment listed on Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 about Standar Nasional Open Application Interface Pembayaran (SNAP) Implementation.

  As the form of suppport and compliance to Bank Indonesia Rules, NICEPAY drives all Merchant to conduct the migration to API SNAP BI.

  All Merchants aim to complete the API SNAP BI migration on June 2024.