Static VA Code Number

2 digits (digit 1-2)

‘90’ – Static Code

6 digits (digit 3-8)

Prefix code for merchant

11 digits (digit 9-19)

VA No sent by merchant

Dynamic VA Code Number

2 digits (digit 1-2)

‘99’ – Dynamic Code

6 digits (digit 3-8)

Prefix code for merchant

20 digits (digit 9-28)

In the request:
‘00000000000000000000’

In the response: number/code generated by system

Static and Dynamic VA Code Number

2 digits (digit 1-2)

‘90’ – Both Static and Dynamic Code

6 digits (digit 3-8)

Prefix code for merchant

11 digits (digit 9-19)

VA No sent by merchant

Static VA Code

√

√

Dynamic VA Code

√

Not supported

HTTP Method

POST

Endpoint

SNAP Test Env URL:

https://perf-openbanking.bankneo.co.id/open/bi/private/1.0.0/transfer-va/create-va

SNAP Prod Env URL: https://openbanking.bankneo.co.id/open/bi/private/1.0.0/transfer-va/create-va

SNAP Service Code

27

X-TIMESTAMP

String

M

25

The request timestamp. Formatted with "yyyy-MM-ddTHH:mm:ssZ". E.g. 2022-09-06T13:00:00+07:00

X-SIGNATURE

String

M

2048

The Merchant or Client generated signature. Using Asymmetric-Signature mechanism to get the token, encrypted with SHA256withRSA. 

e.g. 

stringToSign = <HTTP Method> + ":" + <Service Endpoint> + ":" + toLowercase(hexEncode(SHA256(minify(<Request Body>)))) + ":" + <X-TIMESTAMP>

X-SIGNATURE = SHA256withRSA(PrivateKey, stringToSign)

X-ORIGIN

String

M

256

Client’s host origin.

X-PARTNER-ID

String

M

32

The Merchant or Client Id. Provided by BNC.

X-EXTERNAL-ID

String

M

36

The Merchant External ID of request. 

e.g. 77778042022091500001

CHANNEL-ID

String

M

5

PJP Channel ID. 95221

partnerServiceId

String

M

8

Derivative of X- PARTNER-ID , similar to company code,  8 digit left padding space. partnerServiceId + customerNo or virtualAccountNo.

customerNo

String

M

20

Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo.

virtualAccountNo

String

M

28

partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo

virtualAccountName

String

M

255

Customer name

virtualAccountEmail

String

O

255

Customer email

virtualAccountPhone

String

O

30

Customer’s
phone
number
Format: 62xxxxxxxxxxxxx

trxId

String

M

64

Transaction ID in Partner system

totalAmount

Array of objects

O

-> value

String

M

16,2

Transaction Amount.
Total Amount with 2 decimal (ISO4217)

-> currency

String

M

3

Currency (ISO4217)

billDetails

Array of objects

O

Array with maximum 24 objects

-> billCode

String

O

2

Bill code for Customer choose

-> billNo

String

O

18

Bill number from Partner

-> billName

String

O

20

Bill Name

-> billShortName

String

O

10

Bill Name to shown to

-> billDescription

Object

O

Bill Description

-> -> english

String

O

18

Bill Description in English

-> -> indonesia

String

O

18

Bill Description in Bahasa

-> billSubCompany

String

O

5

Partner's product code

-> billAmount

Array of Objects

O

-> -> value

String (ISO4217)

M

16,2

Transaction Amount.
Nominal inputted by Customer with 2 decimal

-> -> currency

String

M

3

Currency

-> additionalInfo

Object

O

Unlimited

Additional Information for custom use for each bill

freeTexts

Array of Objects

O

Array with maximum 25 Objects

-> english

String

O

32

Will be shown in Channel

-> indonesia

String

O

32

Will be shown in Channel

virtualAccountTrxType

String

O

1

 1. Closed Payment (C)

2. Open Payment (O)

feeAmount

Array of Objects

O

-> value

String (ISO4217)

M

16,2

Transaction Amount.
Nominal inputted by Customer with 2 decimal

-> currency

String

M

3

Currency

expiredDate

String

O

25

Expiration date for Virtual Account. ISO-8601

additionalInfo

Object

O

Additional Information for custom use

responseCode

String

M

7

The BI Snap standard of response code.

responseMessage

String

M

150

The message corresponding to the response code.

virtualAccountData

Object

M

-> partnerServiceId

String

M
partnerServiceId + customerNo or virtualAccountNo

8

Derivative of X- PARTNER-ID , similar to company code,  8 digit left padding space. partnerServiceId + customerNo or virtualAccountNo   

-> customerNo

String

M

20

Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo

-> virtualAccountNo

String

M

28

partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo

-> virtualAccountName

String

M

255

Customer name

virtualAccountEmail

String

O

255

Customer email

-> virtualAccountPhone

String

O

30

Customer’s
phone
number
Format: 62xxxxxxxxxxxxx

-> trxId

String

M

64

from Create VA Request

-> totalAmount

Array of Objects

O

-> -> value

String (ISO4217)

M

16,2

Transaction Amount.
Total Amount with 2 decimal

-> -> currency

String

M

3

Currency

-> billDetails

Array of Objects

O

Array with maximum 24 Objects

-> -> billCode

String

O

2

Bill code for Customer choose

-> -> billNo

String

O

18

Bill number from Partner

-> -> billName

String

O

20

Bill Name

-> -> billShortName

String

O

10

Bill Name to shown to

-> -> billDescription

Object

O

Bill Description

-> -> -> english

String

O

18

Bill Description in English

-> -> -> indonesia

String

O

18

Bill Description in Bahasa

-> -> billSubCompany

String

O

5

Partner's product code

-> -> billAmount

Array of Objects

O

-> -> -> value

String

M

16,2

Transaction Amount.
Nominal inputted by Customer with 2 decimal (ISO 4217)

-> -> -> currency

String

M

3

Currency (ISO4217)

-> -> additionalInfo

Object

O

Unlimited

Additional Information for custom use for each bill

-> -> freeTexts

Array of Objects

O

Array with maximum 25 Objects

-> -> -> english

String

O

32

Will be shown in Channel

-> -> -> indonesia

String

O

32

Will be shown in Channel

-> -> virtualAccountTrxType

String

O

1

 1. Closed Payment (C)

2. Open Payment (O)

-> feeAmount

Array of Objects

O

-> -> value

String (ISO4217)

M

16,2

Transaction Amount.
Nominal inputted by Customer with 2 decimal

-> -> currency

String

M

3

Currency

-> expiredDate

String

O

25

Expiration date for Virtual Account. ISO-8601

-> additionalInfo

Object

O

Additional Information for custom use

2002700

200

any

00

Successful

Successful

4002700

400

any

00

Bad Request

General request failed error, including message parsing failed

4002701

400

any

01

Invalid Field Format {field name}

Invalid format

4002702

400

any

02

Invalid Mandatory Field {field name}

Missing or invalid format on mandatory field

4012700

401

any

00

Unauthorized. [reason]

General unauthorized error (No Interface Def, API is Invalid, Oauth Failed, Verify Client Secret Fail, Client Forbidden Access API, Unknown Client, Key not Found)

4012701

401

any

01

Invalid Token (B2B)

Token found in request is invalid (Access Token Not Exist, Access Token Expiry)

4012703

401

any

03

Token Not Found (B2B)

Token not found in the system. This occurs on any API that requires token as input parameter

4042708

404

any

08

InvalidMerchant

Merchant does not exist or status abnormal

4042711

404

any

11

Invalid Card/Accoun t/Customer [info]/Virtual Account

Card information may be invalid, or the card account may be blacklisted, or Virtual Account number maybe invalid

4042712

404

any

12

Invalid Bill/Virtual Account [Reason]

The bill is blocked/suspended/not found. Virtual account is suspend/not found

4042713

404

any

13

Invalid Amount

The amount doesn't match with what supposed to

4092701

409

any

01

Duplicate partnerReferenceNo

Transaction has previously been processed indicates the same partnerReferenceNo already success

5002702

500

any

02

External Server Error

Backend system failure, etc

M

Mandatory

Mandatory

ME

Mandatory Equal

Mandatory Equal – value in the request and the response must be the same.

C

Conditional

Conditional

CE

Conditional Equal

Conditional Equal – value in the request and the response must be the same.

O

Optional

Optional