NICEPAY API
...
Payment API - SNAP
API Virtual Account SNAP

Notification - API Virtual Account SNAP

9min

About Notification - API Virtual Account SNAP



This API with the SNAP standards uses to send the payment transaction notification on the Virtual Account payment method.



X-SIGNATURE Guidance Validation



The following is guidance to proceed X-SIGNATURE validation on Request Header Notify:

SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP

The following is the example of X-SIGNATURE result from the above guidance validation"

mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+



Merchant Notification - API Virtual Account SNAP



Service Code

25

API Endpoint

[merchant-domain]/api/v1.0/transfer-va/payment

HTTP Method

POST

Content-type

application/json

Description

Transaction Result Notification (when success) If your system use firewall, add allow policy for NICEPAY IP

103.20.51.0/24

103.117.8.0/24



Request Notification Header Parameter

Parameter

Type

Required

Description

Content-Type

String

Mandatory

Application / JSON

X-TIMESTAMP

String

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-CLIENT-KEY

String

Mandatory

Unique Partner ID, Partner ID = Client ID

X-SIGNATURE

String

Mandatory

Request message signature

(85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5)



Request Notification Body Parameter

Parameter

Type

Length

Required

Description

partnerServiceId

String

20

Mandatory

Partner Service ID / Prefix

customerNo

String

40

Mandatory

Customer Number

virtualAccountNo

String

16

Mandatory

Virtual Account Number

virtualAccountName

String

100

Mandatory

Virtual Account Name

trxId

String

40

Mandatory

Transaction ID

(Reference Number from Merchant)

paymentRequestId

String

128

Mandatory

Unique Identifier from NICEPAY

paidAmount

Object

Variable

Mandatory

Amount of paid

value

String

12

Mandatory

Value

currency

String

3

Mandatory

Currency

trxDateTime

String

25

Mandatory

Transaction Date Time

additionalInfo

Object

Variable

Mandatory

Additional information

bankCd

String

4

Mandatory

goodsNm

String

200

Mandatory

Goods Name

vacctValidDt

String

8

Mandatory

Virtual Account Valid Date

vacctValidTm

String

6

Mandatory

Virtual Account Valid Time



Response Notification Header Parameter

Parameter

Type

Required

Description

Content-Type

String

Mandatory

Application / JSON

X-TIMESTAMP

String

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.



Response Notification Body Parameter

Parameter

Type

Length

Required

Description

responseCode

String

7

Mandatory

responseMessage

String

150

Mandatory

Response Message

virtualAccountData

Object

Variable

Mandatory

Virtual Account Data

partnerServiceId

String

20

Mandatory

Partner Service ID / Prefix

customerNo

String

40

Mandatory

Customer Number

virtualAccountNo

String

16

Optional

Virtual Account Number

virtualAccountName

Object

100

Mandatory

Virtual Account Name

trxId

Object

40

Mandatory

Merchant Reference Number

paymentRequestId

String

128

Mandatory

Unique Identifier from NICEPAY

paidAmount

Object

Variable

Mandatory

Amount of paid

value

Object

12

Mandatory

Value

currency

String

3

Mandatory

Currency

trxDateTime

String

25

Mandatory

Transaction Date Time

additionalInfo

Object

Variable

Mandatory

Additional information

bankCd

String

4

Mandatory

goodsNm

String

200

Mandatory

Goods Name



Sample Post For Notification

Sample Request Notification
Sample Response Notification