API References
Create AccountSubmit FeedbackAI Assist (BETA)

Bind Account API

Path/{version}/registration-account-binding
HTTP MethodPOST
Versionv1.0
SNAP service code07

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.
X-PARTNER-IDStringMUnique identifier for merchant. Provided by Midtrans.
X-EXTERNAL-IDStringMAlphanumeric string. We suggest merchant to use UUID format. Reference number that should be unique in the same day or 1 day idempotency key.
CHANNEL-IDStringMMandatory field from Bank Indonesia that can take any value with correct format 5 digits numeric string.
Content-type:application/json
X-TIMESTAMP:2024-03-19T14:30:00+07:00
X-SIGNATURE: da1fa417c72d6b91c257e01e54fac824
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CupvIJbU1Mmu4a11MNDZ7Sg5u9a
X-PARTNER-ID: G123456
X-EXTERNAL-ID:12345678901234567890
CHANNEL-ID:12345

Request Body

Field NameField TypeMandatoryField Description
merchantIdString (64)MMerchant ID (use the same value with merchantId in get-auth-code endpoint)

Merchant payment handle, merchant identifier in UUID format. Provided by Midtrans.
Note: this value is not Midtrans Merchant ID, but a different value, here's the sample format: 303b4f89-xxxx-xxxx-xxxx-62a8ffaefaf3

The value on staging and production is different. Please make sure that you are sending the correct value based on the environment that you are using.
authCodeString(256)MAuth code to exchange with access token. Can get this code from Get Auth Code API response.
grantTypeString (64)MAuth code grant type, possible value = AUTHORIZATION_CODE.
{  
   "authCode":"eyqwwewiasdawwesdwa",
   "merchantId":"550e8400-e29b-41d4-a716-446655440000",
   "grantType":"AUTHORIZATION_CODE"
}

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: 2024-03-19T14:30: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.
referenceNoString (64)MDebug ID to provide more information.
accessTokenInfo
Only returned on successful response		ObjectCAccess token object that contain access token data.
accessTokenInfo.accessToken
Only returned on successful response		String (2048)CAccess token used for transaction (used for Authorization-Customer header).
{
   "responseCode":"2000700",
   "responseMessage":"Request has been processed successfully",
   "referenceNo":"19352694-0ef6-4439-8ad1-b1dfb8bbb85f",
   "accessTokenInfo":{
      "accessToken":"MjAyMjEwMTM2NjE1OGRiMS00NmM1LTQxMWQtYmU4NC01ODk1ZTdhMjg2NmY6OGNmM2U4NWUtZTc3Mi00NTJmLWFkYmEtNDcyNjRiOWZiZWIw"
   }
}

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

List of Response Code

Response CodeHTTP Status CodeResponse Message
2000700200Success
4000702400Invalid Mandatory Field
4010700401Unauthorized. Auth token required
4010701401Invalid Token (B2B)
4040705404Merchant Is Not Registered For Card Registration Services
5000701500Internal Server Error
5040700504Timeout