API Services

Tapcash

Version 1.0
 
1. Top Up
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /tapcash/v2/topup
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-API-Key String Yes API Key
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
signature String Yes Key combination : Digital Signature
provider_id String Yes
tapcashNum String Yes Tapcash card number
fee Numeric Yes
req_doku JSON Yes
Response Definition
Name Type Description
Response (error) See Response Code

Request

{  
   "signature":"[SIGNATURE]",
   "provider_id":"123456",
   "tapcashNum":"345345455555",
   "fee":"0",
   "req_doku":{  
      "req_mall_id":"11237504",
      "req_chain_merchant":"NA",
      "req_amount":"10000.00",
      "req_words":"10af29ef21db59240566e8106f6f30737219e110",
      "req_purchase_amount":"10000.00",
      "req_trans_id_merchant":"11237504",
      "req_request_date_time":"20190213104316",
      "req_currency":"360",
      "req_purchase_currency":"360",
      "req_session_id":"crA6rRbwcpK68zThbMt0",
      "req_name":"test",
      "req_payment_channel":15,
      "req_basket":"Item 1,10000.00,1,10000.00",
      "req_address":"Jakarta",
      "req_email":"test@doku.com",
      "req_token_id":"2354235234mk"
   }
}

Exp full url

https://{BNIServer}:{port}/tapcash/v2/topup?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "responseCode":"OK",
   "res_doku":{  
      "res_tid":"13019501",
      "res_trx_code":"ae9e54a6f0788c41a8c4d468f83fc7c268fc0725",
      "res_currency":"IDR",
      "res_approval_code":"900059",
      "res_eci":"",
      "res_chain_mall_id":"",
      "res_card_number":"4***********1111",
      "res_amount":"15000.00",
      "res_message":"PAYMENT APPROVED",
      "res_issuer_bank":"JPMORGAN CHASE BANK",
      "res_mall_id":"2",
      "res_liability":"MERCHANT",
      "res_mid":"000100013000195",
      "res_result":"SUCCESS",
      "res_payment_date":"20160411180526",
      "res_three_d_secure_status":"FALSE",
      "res_bank":"BNI",
      "res_invoice_number":"1210090970",
      "res_response_code":"0000",
      "res_session_id":"7a573175e3762c01145be0ae155fcacedce030e3",
      "res_payment_channel":"15"
   },
   "res_top_up_pending":{  

   }
}

Response (Error)

{  
   "responseCode":"FAIL",
   "OKContent":"",
   "FAILContent":"Value cannot be null.\r
Parameter name: s"
}
 
2. Update Balance
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /tapcash/v2/updatebalance
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-API-Key String Yes API Key
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
signature String Yes Key combination : Digital Signature
cardData String Yes Tapcash data read from card
reffNum String Yes Refference number. Max 20 chars. Format: yyyyMMddHHmmssSSSXXX. XXX: client defined or random number
Response Definition
Name Type Description
errorCode String Error Code
cardData String Tapcash data read from card
localTime String Local transaction time
amount Numeric Transaction amount
authIDResp Numeric Authorization identification response
origSTAN Numeric System trace audit number
localDate String Local transaction date
criptogram String Criptogram response from Server to write to card
rrn Numeric Retrieval reference number
errorDescription String Error Description
Response (error) See Response Code

Request

{  
   "signature":"[SIGNATURE]",
   "reffNum":"20170926145209000668",
   "cardData":"000112345600000003891234560000000389AC4BC1A4E1E39A3F54D3FBC6E2640E6200000000010000000000000000000000000000000000016901F0BDC02AAA06E1535643202037362000008CEAB3C371D3C92F4FC8E44085F5533C"
}

Exp full url

https://{BNIServer}:{port}/tapcash/v2/updatebalance?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "cardData":"000112345600000003891234560000000389AC4BC1A4E1E39A3F54D3FBC6E2640E6200000000010000000000000000000000000000000000016901F0BDC02AAA06E1535643202037362000008CEAB3C371D3C92F4FC8E44085F5533C",
   "localTime":145209,
   "amount":10000,
   "authIDResp":358638,
   "origSTAN":668,
   "localDate":"0926",
   "criptogram":"060027102AC4791F00000000000000000AF5A63C2FA31C2FCE9EEDED503B4ED4",
   "rrn":956080179
}

Response (Error)

{  
   "errorDescription":"Data not found",
   "errorCode":14
}