Account Binding Inquiry API

Path/{version}/registration-account-inquiry
HTTP MethodPOST
Versionv1.0
SNAP service code08

Request Header

Field NameField TypeMandatoryField Description
Content-typeStringMMedia type of the resource, i.e. application/json
X-TIMESTAMPStringMClient’s current local time in ISO-8601 format
X-SIGNATUREStringMCreated using symmetric signature HMAC_SHA512 algorithm
AuthorizationStringMRepresents access_token of a request; string starts with keyword “Bearer ” followed by access_token. Can get this token from Access Token B2B API response.
Authorization-CustomerStringMRepresents access_token of a request; string starts with keyword “Bearer ” followed by access_token from Binding API response
X-PARTNER-IDStringMUnique identifier for merchant. Merchant can send any value.
X-EXTERNAL-IDStringMNumeric string. Reference number that should be unique in the same day or 1 day idempotency key.
X-DEVICE-IDStringMDevice identification on which the API services is currently being accessed by the end user (customer)
CHANNEL-IDStringMChannel ID Device identification on which the API services are currently being accessed by the end user. Given by BI.
Content-type:application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CupvIJbU1Mmu4a11MNDZ7Sg5u9a
Authorization-Customer : Bearer MjAyMjEwMTM2NjE1OGRiMS00NmM1LTQxMWQtYmU4NC01ODk1ZTdhMjg2NmY6OGNmM2U4NWUtZTc3Mi00NTJmLWFkYmEtNDcyNjRiOWZiZWIw
X-TIMESTAMP:2020-01-01T00:00:00+07:00
X-PARTNER-ID: BMRI
X-SIGNATURE: da1fa417c72d6b91c257e01e54fac824
X-DEVICE-ID: 0987ADCASA
X-EXTERNAL-ID:1234567890123456789
CHANNEL-ID:12345

Request Body

Field NameField TypeMandatoryField Description
additionalInfoObjectOSome additional info
additionalInfo.accountIdStringOAccount ID from legacy Core API flow
{
    "additionalInfo":{
      “accountId” : “acd52694-0ef6-4439-8ad1-b1dfb8bb111“
     } 
}

Response Header

Field NameField TypeMandatoryField Description
Content-typeStringMMedia type of the resource, i.e. application/json
X-TIMESTAMPStringMClient’s current local time in ISO-8601 format
Content-type: application/json
X-TIMESTAMP: 2020-01-01T00:00:00+07:00

Response Body

Field NameField TypeMandatoryField Description
responseCodeString (7)MError code to specify the error returned.
responseMessageString (150)MDebug message to provide more information.
referenceNoStringMDebug id to provide more information.
additionalInfo
Only returned in successful response
ObjectCSome additional info
additionalInfo.accessToken
Only returned in successful response
StringCAccess token used for transaction (used for Authorization-Customer header)
additionalInfo.paymentType
Only returned in successful response
CSome payment type
additionalInfo.paymentOptions
Only returned in successful response
ObjectCList of payment options
additionalInfo.paymentOptions.name
Only returned in successful response
StringCAccount balance name for each payment options.
additionalInfo.paymentOptions.active
Only returned in successful response
BooleanCFlag to mark if payment option is active.
additionalInfo.paymentOptions.balance
Only returned in successful response
ObjectCLinked account balance for each payment options.
additionalInfo.paymentOptions.balance.value
Only returned in successful response
StringCAccount balance value for each payment options.
additionalInfo.paymentOptions..balance.currency
Only returned in successful response
StringCAccount balance currency for each payment options.
additionalInfo.paymentOptions.token
Only returned in successful response
StringCToken that need to be use on Gopay Tokenization charge request.

{
   "responseCode":"2000800", 
   "responseMessage":"Request has been processed successfully", 
   "referenceNo":"19352694-0ef6-4439-8ad1-b1dfb8bbb85f", 
   "additionalInfo":{
     "accessToken": "MjAyMjEwMTM2NjE1OGRiMS00NmM1LTQxMWQtYmU4NC01ODk1ZTdhMjg2NmY6OGNmM2U4NWUtZTc3Mi00NTJmLWFkYmEtNDcyNjRiOWZiZWIw",
     "paymentType": "gopay",
     "paymentOptions": [
           {
               "name": "GOPAY_WALLET",
               "active": true,
               "balance": {
                   "value": "7985000.00",
                   "currency": "IDR"
               },
               "token": "f527bf45-1612-4ec0-bec0-5c407e33adef"
           }
      ]

   }
}
{
   "responseCode":"5000800",
   "responseMessage":"Timeout",
   "referenceNo":"19352694-0ef6-4439-8ad1-b1dfb8bbb85f"
}

List of Response Code

Response CodeHTTP Status CodeResponse Message
2000800200Success
4000802400Invalid Mandatory Field
4010800401Unauthorized
4010801401Invalid Token (B2B)
4010802401Invalid Customer Token
4040805404Merchant Is Not Registered For Card Registration Services
4010802401Invalid Customer Token

Note: we will return this when the account linking is already INACTIVE. Applies if merchant passes Authorization-Customer on request header.
4030818403Inactive Card/Account/Customer

Note: we will return this when the account linking is already INACTIVE. Applies if merchant passes AccountID (from legacy API) on request header.
5000801500Internal Server Error
5040800504Timeout