Access Token B2B & B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Tentang Access Token B2B & B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Bagian ini berisi tentang rincian informasiļ»æ terkait kebutuhan akses token APIļ»æ dengan standar SNAPļ»æ digunakan agar dapat melakukan prosesļ»æ terkait B2B dan B2B2C.
Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP
Kunjungi halamanļ»æ Account Binding - API E-Wallet (Direct Debit) SNAPļ»æ untuk mengetahui alur mendapatkan akses token pada prosesļ»æ account binding.
Access Token B2B digunakan oleh Merchantļ»æ untuk menginisiasi prosesļ»æ transaksiļ»æ dengan sistemļ»æ NICEPAYļ»æ.
Service Code | 73 |
|---|---|
API Endpoint | /nicepay/v1.0/access-token/b2b |
Method | POST |
Description | Get Access Token B2B Specification |
ļ»æ
Request Header Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
Content-Type | String | Variable | Mandatory | Application/Json |
X-TIMESTAMP | String | Variable | Mandatory | yyyy-MM-ddTHH:mm:ss.SSSTZD (2022-03-21T10š40+07:00) |
X-CLIENT-KEY | String | Variable | Mandatory | ļ»æNICEPAYļ»æ Credential Client ID |
X-SIGNATURE | String | Variable | Mandatory | X-SIGNATURE: created using asymmetric signature SHA256withRSA algorithm (Private_Key, stringToSign) stringToSign = client ID + ā|ā + X-TIMESTAMP |
ļ»æ
Request Body Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
grantType | String | Variable | Mandatory | Grant Type Value: āclient_credentialsā |
additionalInfo | JSON Object | Variable | Mandatory | Additional Information |
ļ»æ
Response Header Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
Content-Type | String | Variable | Mandatory | Content type, value always application/json |
X-TIMESTAMP | String | Variable | Mandatory | Transaction date time, in format YYYY-MMDDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time) |
ļ»æ
Response Body Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
responseCode | String | Variable | Mandatory | Refer to response code list |
responseMessage | String | Variable | Mandatory | Debug message to provide informationļ»æ |
accessToken | String | 2048 | Mandatory | Token Authorization that NICEPAYļ»æ used for Shopee Pay APIļ»æ Services |
tokenType | String | Variable | Mandatory | Token Type Value: āBearerā |
expiresIn | String | 3 | Mandatory | Token Validate Time |
ļ»æ
Sample Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP
Request Parameter
$config = NICEPay::builder()
->setIsProduction(false)
->setIsCloudServer(true)
->setPrivateKey($private_key)
->setClientSecret($client_secret)
->setPartnerId("IONPAYTEST")
->setExternalID("eXid202402111402271707638098")
->setTimestamp("2024-01-31T10:11:40+07:00")
->build();
$data = AccessToken::builder()
->setGrantType("client_credentials")
->setAdditionalInfo([])
->build();
$snap = new Snap($config);
$response = $snap->requestSnapAccessToken($data);Response Parameter
{
"responseCode": "2007300",
"responseMessage": "Successful",
"accessToken": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1",
"tokenType": "Bearer",
"expiresIn": "900"
}ļ»æ
Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Access Token B2B2C digunakan oleh Merchantļ»æ untuk menginisiasi prosesļ»æ transaksiļ»æ Pelangganļ»æ menggunakan akun yangļ»æ sudah terhubung pada sistemļ»æ NICEPAYļ»æ.
Service Code | 74 |
|---|---|
API Endpoint | /nicepay/api/v1.0/access-token/b2b2c |
Method | POST |
Description | Get Access Token B2B2C Specification |
ļ»æ
Request Header Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
Content-Type | String | Variable | Mandatory | Application/Json |
X-TIMESTAMP | String | Variable | Mandatory | yyyy-MM-ddTHH:mm:ss.SSSTZD (2022-03-21T10š40+07:00) |
X-CLIENT-KEY | String | Variable | Mandatory | ļ»æNICEPAYļ»æ Credential Client ID |
X-SIGNATURE | String | Variable | Mandatory | X-SIGNATURE: created using asymmetric signature SHA256withRSA algorithm (Private_Key, stringToSign) stringToSign = Client ID + ā|ā + X-TIMESTAMP |
ļ»æ
Request Body Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
grantType | String | 32 | Mandatory | Apply token request key type, can be AUTHORIZATION_CODE or REFRESH_TOKEN |
authCode | String | 256 | Conditional | The authorization code received after theļ»æ User provides theļ»æ consent. Mandatory if grantType = AUTHORIZATION_CODE |
refreshToken | String | 512 | Conditional | Refresh token to get a new accessToken where theļ»æ User doesn't need to provide theļ»æ consent again. Mandatory if grantType = REFRESH_TOKEN. Refresh Token should be less than access token validity and will be manage by theļ»æ PJPās application to generate a new access_token. |
additionalInfo | JSON Object | Variable | Mandatory | Additional informationļ»æ |
partnerReferenceNo | String | 40 | Mandatory | ļ»æMerchantļ»æ transactionļ»æ identifier from NICEPAYļ»æļ»æ |
mitraCd | String | 4 | Mandatory | ļ»æNICEPAYļ»æ Mitraļ»æ Code AstraPay : ASTR AlloBank : ALLO |
ļ»æ
Response Header Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
Content-Type | String | Variable | Mandatory | Content type, value always application/json |
X-TIMESTAMP | String | Variable | Mandatory | Transaction date time, in format YYYY-MMDDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time) |
ļ»æ
Response Body Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
responseCode | String | 7 | Mandatory | Refer to response code list |
responseMessage | String | 40 | Mandatory | Debug message to provide more informationļ»æ |
accessToken | String | 50 | Mandatory | Authorization in theļ»æ form of a string given to theļ»æ user and used to access protected resources |
tokenType | String | 50 | Mandatory | Bearer Token |
accessTokenExpiryTime | String | 50 | Mandatory | Access token valid time will be 15 days format ISO8601 |
refreshToken | String | 50 | Mandatory | Random string used by theļ»æ user to get a new accessToken to access user data by format UUID |
refreshTokenExpiryTime | String | 50 | Mandatory | Time for theļ»æ refreshToken to expire |
additionalInfo | JSON Object | Variable | Mandatory | Additional informationļ»æļ»æ |
partnerReferenceNo | String | 40 | Mandatory | ļ»æMerchantļ»æ transactionļ»æ identifier from NICEPAYļ»æļ»æ |
referenceNo | String | 40 | Mandatory | ļ»æNICEPAYļ»æ Transaction ID |
mitraCd | String | 4 | Mandatory | ļ»æNICEPAYļ»æ Mitraļ»æ Code AstraPay : ASTR Allo Bank : ALLO |
ļ»æ
Sample Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP
Request Parameter
curl -X POST \
'https://dev.nicepay.co.id/nicepay/v1.0/access-token/b2bc' \
-H 'Content-Type: application/json' \
-H 'X-SIGNATURE: aFHq5SNdWO5Pq2vwZk4ztd9Cu3OvblG6NezGwLX3GC2mRJorDHPeZpR3V+RXrPC8ojcyCwQy01FSipmA8YdQvz1hOth7aekXzhigYCRNS34EHYEoFGD1YMHVFRvxn2Fu8HAd6wTvPNy2X2rbUS3hWrJsfa5cHu8wKVb7zPCuxNc=' \
-H 'X-CLIENT-KEY: IONPAYTEST' \
-H 'X-TIMESTAMP: 2024-01-31T10:11:40+07:00' \
-d '{"grantType":"AUTHORIZATION_CODE","authCode":"3p8Uuq0dkDBPagBvbFIo1QodNzZaJJXXITpL9mFRsWAS","refreshToken":"3911773a-d3ac-4b4f-8a6c-406c21d6883d","additionalInfo":{"partnerReferenceNo":"202208121451526358","mitraCd":"ASTR"}}'Response Parameter
{
"grantType": "AUTHORIZATION_CODE",
"authCode": "3p8Uuq0dkDBPagBvbFIo1QodNzZaJJXXITpL9mFRsWAS",
"refreshToken": "3911773a-d3ac-4b4f-8a6c-406c21d6883d",
"additionalInfo": {
"partnerReferenceNo": "202208121451526358",
"mitraCd": "ASTR"
}
}