NICEPAY API
...
Payment API - SNAP
API E-Wallet (Direct Debit) SN...

Registration - API E-Wallet (Direct Debit) SNAP

7min

Tentang Registration - API E-Wallet (Direct Debit) SNAP



API ini digunakan untuk mengajukan pendaftaran transaksi melakukan pembayaran menggunakan metode pembayaran E-Wallet dengan Fitur Direct Debit Host to Host yang sesuai standar SNAP BI.

Registration - API E-Wallet (Direct Debit) SNAP



Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian Request Access Token API - SNAP.

Service Code

54

API Endpoint

HTTP Method

POST

Description

Request Direct Debit transaction for authentication payment

Content-type

application/json



Request Registration Header Parameter

Parameter

Tipe

Ukuran

Kebutuhan

Deskripsi

Content-Type

String

127

Mandatory

Content type, value always application/json

Authorization

String

Variable

Mandatory

Bearer “accessToken

X-TIMESTAMP

String

25

Mandatory

Using ISO 8601 as timestamp format.

Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00.

Time must be in GMT+7 (Jakarta time).

2022-03-21T10:11:40+07:00.

X-SIGNATURE

String

Variable

Mandatory

Signature will be generated automatically by Merchant

X-PARTNER-ID

String

20

Mandatory

Unique Partner ID, Partner ID = Client ID

X-EXTERNAL-ID

String

40

Mandatory

Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction.

CHANNEL-ID

String

5

Mandatory

Device identification on which the API services is currently being accessed by the End User (Customer)



Request Registration Body Parameter

Parameter

Tipe

Kebutuhan

Ukuran

Deskripsi atau Contoh

partnerReferenceNo

String

Mandatory

40

Transaction ID from Merchant

merchantId

String

Mandatory

10

Merchant Identifier that is unique per each Merchant

subMerchantId

String

Optional

32

Sub-Merchant Identifier

externalStoreId

String

Optional

32

Unique Identifier of Shop ID in Client system

amount

Array of JSON Object

Mandatory

Variable

Amount Information

value

String

Mandatory

12

Transaction amount, including thecents

currency

String

Mandatory

3

Currency code based on ISO

urlParam

Array of JSON Object

Mandatory

Variable

Notify URL that Merchant must send the payment notification

url

String

Mandatory

512

Indicates the URL of the Client’s app to redirect back to once payment has been completed in Merchant.

Merchant accepts HTTP links and URL scheme formats.

type

String

Mandatory

32

Indicates the type of the sent URL. Only accepts ‘PAY_RETURN” and ‘PAY_NOTIFY” value.

isDeeplink

String

Mandatory

1

Indicates whether the URL is a deep link or not, only accepts ‘Y’ value

validUpTo

String

Optional

25

The time when the payment will be automatic only expired. ISO 8601, in YYYY-MMDDTHH format.

mm:ss+07:00. Time must be in GMT+7 (Jakarta time).

pointOfInitiation

String

Optional

20

Used for getting more info regarding source of request of the ser

additionalInfo

Array of JSON Object

Optional

Variable

Additional information

"additionalInfo":{...}

mitraCd

String

Mandatory

4

Example: OVO: OVOE Link Aja: LINK DANA: DANA

ShopeePay: ESHP

goodsNm

String

Mandatory

200

Goods Name

billingNm

String

Mandatory

100

Buyer Name

billingPhone

String

Mandatory

20

Buyer Phone Number

callBackUrl

String

Mandatory

500

Payment result forward URL (on browser)

dbProcessUrl

String

Mandatory

500

Payment Notification URL (Async Notification)

cartData

String

Mandatory

4000

{JSON_Format}

msId

String

Optional

20

Merchant Seller ID

msFee

String

Optional

7

Merchant Seller Fee

msFeeType

String

Optional

2

Merchant Seller Fee Type

mbFee

String

Optional

7

Merchant Balance Fee

mbFeeType

String

Optional

2

Merchant Balance Fee Type



Response Registration Parameter

Parameter

Tipe

Kebutuhan

Ukuran

Deskripsi atau Contoh

responseCode

String

Mandatory

7

responseMessage

String

Mandatory

150

partnerReferenceNo

String

Mandatory

40

Merchant transaction identifier

referenceNo

String

Mandatory

40

Original transaction identifier on service provider system

appRedirectUrl



String

Optional

2048

Returns an URL scheme to payment page in native app

For ShopeePay, this value will be deprecated

webRedirectUrl

String

Optional

2048

Partner checkout URL

additionalInfo

String

Optional

Variable

Additional information

"additionalInfo": { ...}

redirectToken

String

Optional

255

Partner checkout token



Sample Parameter

Sample Request
Sample Response