Skip to main content

Transaction Detail

POST/v1.0/transaction-history-detail.htm

This API is used to query user’s DANA transaction history detail via merchant. For the easiest integration, use DANA's Libraries to implement DANA Widget Binding.

API Type
SNAP API
Expected Timeout
8 second
SNAP Service Code
13
Accept
application/json
Content Type
application/json
Content-Type
string
1 - 127 charactersRequired
Content type, value always application/json
Authorization-Customer
string
1 - 512 charactersRequired
Contains customer token, which has been obtained from binding process
X-TIMESTAMP
string
25 charactersRequired
Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00.
Time must be in GMT+7 (Jakarta time)
X-SIGNATURE
string
Required
Signature need to be generated with asymmetricSignature method
ORIGIN
string
Origin domain
X-PARTNER-ID
string
1 - 36 charactersRequired
Unique identifier for partner was generated by DANA, or known as clientId
X-EXTERNAL-ID
string
1 - 36 charactersRequired
Unique messaging reference identifier generated by merchant and should be unique within the same day
X-IP-ADDRESS
string
15 characters
IP address of the end user (customer) using IPv4 format
X-DEVICE-ID
string
1 - 400 charactersRequired
Device identification on which the API services is currently being accessed by the end user (customer). Sample:
  • Web Application:
    • Mozilla / 5.0 (Windows NT 10.0; Win64; x64)
    • AppleWebKit / 537.36 (KHTML, like Gecko)
    • Chrome / 75.0.3770.100
    • Safari / 537.36 OPR / 62.0.3331.99
  • Mobile Application:
    • Android: android-20013adf6cdd8123f
    • iOS: 72635bdfd223yvjm7246nsdj34hd4559393kjh42"
X-LATITUDE
string
1 - 10 characters
Location on which the API services is currently being accessed by the end user (customer), refer to ISO 6709 standard representation of geographic point location by coordinates, as below:
  • ±DD.DDDD format (without minutes and seconds)
  • ±DD = three-digit integer degrees part of latitude
  • .DDDD = variable-length fraction part in degrees
Sample:
New York City
Latitude: +40.75
X-LONGITUDE
string
1 - 10 characters
Location on which the API services is currently being accessed by the end user (customer), refer to ISO 6709 Standard representation of geographic point location by coordinates, as below:
  • ±DDD.DDDD format (without minutes and seconds)
  • ±DDD = four-digit integer degrees part of latitude
  • .DDDD = variable-length fraction part in degrees
Sample:
New York City
Longitude: -074.00
CHANNEL-ID
string
1 - 5 charactersRequired
Device identification on which the API services is currently being accessed by the end user (customer)
originalPartnerReferenceNo
string
1 - 64 charactersRequired
Original transaction identifier on partner system
additionalInfo
json object
Additional information
additionalInfo.accessToken
string
1 - 512 charactersRequired
Contains customer token, which has been obtained from binding process
additionalInfo.referenceNo
string
1 - 64 charactersRequired
Additional information of transaction identifier on DANA system
POST .../v1.0/transaction-history-detail.htm HTTP/1.2
Content-type: application/json
Authorization-Customer: Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a
X-TIMESTAMP: 2020-12-23T08:31:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
X-IP-ADDRESS: 172.24.281.24
X-DEVICE-ID: 09864ADCASA
X-LATITUDE: -6.108841
X-LONGITUDE: 106.7782137
CHANNEL-ID: 95221
{
    "originalPartnerReferenceNo":"2020102900000000000001",
    "additionalInfo":
    {
        "accessToken": "fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a",
        "referenceNo": "202203297381273166738217381"
    }
}
Content-Type
string
1 - 127 charactersRequired
Content type, value always application/json
X-TIMESTAMP
string
25 charactersRequired
Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
responseCode
string
7 charactersRequired
Refer to response code list
responseMessage
string
1 - 150 charactersRequired
Refer to response code list
referenceNo
string
1 - 64 charactersConditional
Transaction identifier on DANA system
Conditional Info
Y:= Data found
partnerReferenceNo
string
1 - 64 charactersConditional
Unique transaction identifier in partner system for each transaction.
Note: When retrying after a timeout or unexpected response, use the same partnerReferenceNo as in the original request
Conditional Info
Y:= Data found
amount
money
Conditional
Amount. Contains two sub-fields:
  1. Value: Transaction amount, including the cents
  2. Currency: Currency code based on ISO
Conditional Info
Y:= Data found
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
cancelledTime
string
25 characters
Transaction cancelled time, in format YYYY-MM-DDTHH:mm:ssZ.
Time must be in UTC
dateTime
string
25 charactersConditional
Transaction date time, in format YYYY-MM-DDTHH:mm:ssZ.
Time must be in UTC
Conditional Info
Y:= Data found
refundAmount
money
Refund amount. Contains two sub-fields:
  1. Value: Amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
remark
string
1 - 256 characters
Transaction remark
sourceOfFunds
array of json object
Source of fund used for this transaction. For this service, only use payMethod and amount parameter
source
string
1 - 64 charactersRequired
Fund source
amount
money
Required
Amount. Contains two sub-fields:
  1. Value: Transaction amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
status
string
1 - 32 charactersConditional
Transaction status. i.e., CLOSED, FAILED, INIT, SUCCESS, PROCESSING, EXPIRED, ISSUED, REDEEMED, REFUNDED, REVOKED
Conditional Info
Y:= Data found
type
string
1 - 32 charactersConditional
Transaction type. i.e., PAYMENT, REFUND, OFFLINE_TOPUP, TOP_UP, COMMON_REBATE, REBATE, WITHDRAW
Conditional Info
Y:= Data found
additionalInfo
string
Additional information
additionalInfo.feeAmount
money
Additional information of fee amount. Contains two sub-fields:
  1. Value: Amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
additionalInfo.orderModifiedTime
string
25 charactersConditional
Additional information of last order modified time, in format YYYY-MM-DDTHH:mm:ssZ. Time must be in UTC
Conditional Info
Y:= Data found
additionalInfo.orderCompletedTime
string
25 characters
Additional information of order completed time, in format YYYY-MM-DDTHH:mm:ssZ.
Time must be in UTC
additionalInfo.orderExpireTime
string
25 characters
Additional information of order expired time, in format YYYY-MM-DDTHH:mm:ssZ.
Time must be in UTC
additionalInfo.ipRoleId
string
1 - 64 characters
Additional information of DANA user's IP role identifier
additionalInfo.nickname
string
1 - 64 characters
Additional information of DANA user's nickname
additionalInfo.targetIpRoleType
string
1 - 64 characters
Additional information of target's type
additionalInfo.targetIpRoleId
string
1 - 64 characters
Additional information of target's user identifier
additionalInfo.targetNickname
string
1 - 64 characters
Additional information of target's nickname
additionalInfo.externalUserId
string
1 - 64 characters
Additional information of DANA external user identifier
additionalInfo.partnerRoleId
string
1 - 64 characters
Additional information of merchant identifier
additionalInfo.partnerNickname
string
1 - 64 characters
Additional information of partner nickname
additionalInfo.orderTitle
string
1 - 64 characters
Additional information of order title
additionalInfo.isFreeze
string
1 characters
Additional information of the status of order is frozen or not.
The values are 0/1
additionalInfo.isRefunded
string
1 characters
Additional information of the status of order is refunded or not.
The values are 0/1
additionalInfo.subBizOrderType
string
1 - 64 characters
Additional information of sub business order type
additionalInfo.subBizOrderStatus
string
1 - 64 characters
Additional information of sub business order status
additionalInfo.refBizOrderId
string
1 - 64 characters
Additional information of reference business order identifier
additionalInfo.requestSource
string
1 - 64 characters
Additional information of request source
additionalInfo.userPaidAmount
money
Additional information of user paid amount. Contains two sub-fields:
  1. Value: Amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
additionalInfo.bizScenario
string
1 - 32 characters
Additional information of business scenario
additionalInfo.extendInfo
string
1 - 4096 characters
Additional information of extend
additionalInfo.totalAmount
money
Additional information of total amount. Contains two sub-fields:
  1. Value: Amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
additionalInfo.originalOrderAmount
money
Additional information of original order amount. Contains two sub-fields:
  1. Value: Amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
additionalInfo.merchantName
string
1 - 64 characters
Additional information of merchant name
additionalInfo.productCode
string
1 - 32 characters
Additional information of product code
additionalInfo.orderDetailList
array of json object
Additional information of order detail list, contains pay order detail such as payMethod and coupon
bizOrderDetailId
string
1 - 64 characters
Business order detail identifier
bizOrderDetailType
string
1 - 32 characters
Business order detail type
detailOrderStatus
string
1 - 32 characters
Detail order status
refBizOrderDetailId
string
1 - 64 characters
Reference business order detail identifier
refBizOrderDetailType
string
1 - 32 characters
Reference business order detail type
extendInfo
string
1 - 4096 characters
Extend information
payment
json object
Payment info
acceptedTime
string
25 characters
Payment accepted time, in format YYYY-MM-DDTHH:mm:ssZ.
Time must be in UTC
amount
money
Amount. Contains two sub-fields:
  1. Value: Transaction amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
paymentOrderId
string
1 - 64 characters
Payment order identifier
status
string
1 - 32 characters
Payment status
paymentBizType
string
1 - 32 characters
Payment business type
paymentDetailList
array of json object
Payment detail information
moneyAmount
money
Money amount. Contains two sub-fields:
  1. Value: Amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
paymentDetailId
string
1 - 64 characters
Payment detail identifier
status
string
1 - 32 characters
Pay status
coupons
array of json object
Coupons information
couponId
string
1 - 32 characters
Coupon identifier
amount
money
Coupon amount. Contains two sub-fields:
  1. Value: Coupon amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
expiredDate
string
25 characters
Coupon expired date, in format YYYY-MM-DDTHH:mm:ssZ. Time must be in UTC
couponCode
string
1 - 32 characters
Coupon code
canRefund
string
1 characters
Has values:
  • 0 = false
  • 1 = true
orderCreatedTime
string
25 characters
Order created time, in format YYYY-MM-DDTHH:mm:ssZ.
Time must be in UTC
orderCompletedTime
string
25 characters
Order completed time, in format YYYY-MM-DDTHH:mm:ssZ.
Time must be in UTC
assetBelong
string
1 - 16 characters
Asset belong to PAYER/PAYEE
totalDiscount
money
Total discount amount. Contains two sub-fields:
  1. Value: Amount, including the cents
  2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g. ,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
accountNo
string
1 - 64 characters
Account number
instId
string
1 - 32 characters
Institution identifier
payMethod
string
1 - 32 characters
Pay method
Content-type: application/json
X-TIMESTAMP: 2020-12-18T15:55:47+07:00
{
    "responseCode": "2001300",
    "responseMessage": "Successful",
    "referenceNo": "2020102977770000000009",
    "partnerReferenceNo": "2020102900000000000001",
    "amount": {
        "value": "12345678.00",
        "currency": "IDR"
    },
    "cancelledTime": "2020-12-23T08:31:11Z", 
    "dateTime": "2020-12-23T08:31:11Z",
    "refundAmount": {
        "value": "12345678.00",
        "currency": "IDR"
    },
    "remark": "Payment to Warung Ikan Bakar",
    "sourceOfFunds": [
      {
          "source": "BALANCE",
          "amount": {
              "value": "10000.00",
              "currency": "IDR"
          },
      }
    ],
    "status": "SUCCESS",
    "type": "PAYMENT",
    "additionalInfo": {
        "feeAmount": {
            "currency": "IDR",
            "value": "0.00"
        },
        "orderModifiedTime": "2020-12-23T08:31:11Z",
        "orderCompletedTime": "2020-12-23T08:31:11Z",
        "orderExpiryTime": "2020-12-23T08:31:11Z",
        "ipRoleId": "216610000187003188462",
        "nickname": "85158225425",
        "targetIpRoleType": "SELLER",
        "targetIpRoleId": "216610000187003188463",
        "targetNickname":"Warung Ikan Bakar",
        "externalUserId": "531481296",
        "partnerRoleId": "216620000001496726697",
        "partnerNickname": "Warung Ikan Bakar",
        "orderTitle": "Order BL2217EBTY99INV Payment Reduction",
        "isFreeze": "0",
        "isRefunded": "0",
        "subBizOrderType": "REFUND_TO_SOURCE",
        "subBizOrderStatus": "SUCCESS",
        "refBizOrderId": "20211309111212800100166262022329202",
        "requestSource": "EMPTY",
        "userPaidAmount": {
            "currency": "IDR",
            "value": "0.00"
        },
        "bizScenario": "PAYMENT",
        "extendInfo": "{\"key\":\"value\"}",
        "totalAmount": {
            "currency": "IDR",
            "value": "1000.00"
        },
        "originalOrderAmount": {
            "currency": "IDR",
            "value": "0.00"
        },
        "merchantName": "Bukalapak",
        "productCode": "51051000100000000031",
        "orderDetailList": [
          {
              "bizOrderDetailId": "2021939218318391283912839183",
              "bizOrderDetailType": "VIRTUAL",
              "detailOrderStatus": "SUCCESS",
              "refBizOrderDetailId": "63721632713712367213",
              "refBizOrderDetailType": "VIRTUAL",
              "extendInfo": "{\"key\":\"value\"}",
              "payment": {
                  "acceptedTime": "2020-12-23T08:31:11Z",
                  "amount": {
                      "currency": "IDR",
                      "value": "1000.00"
                  },
                  "paymentOrderId": "2022030910110000010000DANAW3ID166468845688115",
                  "status": "SUCCESS",
                  "paymentBizType": "AMOUNT_PREPARE",
                  "paymentDetailList": [
                    {
                      "moneyAmount": {
                          "currency": "IDR",
                          "value": "1000.00"
                      },
                      "paymentDetailId": "2022030910110000014000DANAW3ID166468817381257",
                      "status": "SUCCESS",
                      "coupons": [],
                      "orderCreatedTime": "2020-12-23T08:31:11Z",
                      "orderCompletedTime": "2020-12-23T08:31:11Z",
                      "assetBelong": "PAYEE",
                      "totalDiscount": {}
                    },
                    {
                    "accountNo": "20070000000021365694",
                    "moneyAmount": {
                        "currency": "IDR",
                        "value": "1000.00"
                    },
                    "paymentDetailId": "2022030910110000019000DANAW3ID166468817381256",
                    "status": "SUCCESS",
                    "coupons": [],
                    "orderCreatedTime": "2020-12-23T08:31:11Z",
                    "orderCompletedTime": "2020-12-23T08:31:11Z",
                    "assetBelong": "PAYER",
                    "totalDiscount": {}
                    }
                  ]
                }
          },
          {
              "bizOrderDetailType": "VIRTUAL",
              "payment": {
                  "acceptedTime": "2020-12-23T08:31:11Z",
                  "amount": {
                      "currency": "IDR",
                      "value": "1000.00"
                  },
                  "paymentOrderId": "2022030910110000040000DANAW3ID166468826144818",
                  "status": "SUCCESS",
                  "paymentBizType": "REFUND",
                  "paymentDetailList": [
                    {
                      "instId": "DANAW3ID",
                      "moneyAmount": {
                          "currency": "IDR",
                          "value": "1000.00"
                      },
                      "paymentDetailId": "2022030910110000041200DANAW3ID166468826336292",
                      "payMethod": "REBATE",
                      "status": "SUCCESS",
                      "coupons": [
                      {
                          "couponId": "2022030910111500110000000000460005785026",
                          "amount": {
                              "currency": "IDR",
                              "value": "1000.00"
                          },
                          "expiredDate": "2020-12-23T08:31:11Z",
                          "couponCode": "DANA",
                          "canRefund": "0"
                      }
                      ],
                      "orderCreatedTime": "2020-12-23T08:31:11Z",
                      "orderCompletedTime": "2020-12-23T08:31:11Z",
                      "assetBelong": "PAYEE",
                      "totalDiscount": {
                          "currency": "IDR",
                          "value": "1000.00"
                      }
                    },
                    {
                      "moneyAmount": {
                          "currency": "IDR",
                          "value": "1000.00"
                      },
                      "paymentDetailId": "2022030910110000044000DANAW3ID166468826336293",
                      "status": "SUCCESS",
                      "coupons": [],
                      "orderCreatedTime": "2020-12-23T08:31:11Z",
                      "orderCompletedTime": "2020-12-23T08:31:11Z",
                      "assetBelong": "PAYER",
                      "totalDiscount": {}
                    }
                  ]
              }
          }
        ]
    }
}

ResponseCauseSolution
2001300Successful
Success to be processed
Mark Transaction Detail process as Success
4001300Bad Request
General request failed error
Mark Transaction Detail process as Failed. Retry request with proper parameter
4001301Invalid Field Format
Invalid format for certain field
Mark Transaction Detail process as Failed. Retry request with proper parameter
4001302Invalid Mandatory Field
Missing or invalid format on mandatory field
Mark Transaction Detail process as Failed. Retry request with proper parameter
4011300Unauthorized. [reason]
General unauthorized error
Mark Transaction Detail process as Failed. Retry request with proper parameter
4011302Invalid Customer Token
Customer token are invalid, perhaps due to token expiry
Mark Transaction Detail process as Failed. Retry request with proper parameter
4011304Customer Token Not Found
Customer token not found in the system. This occurs on any API that requires token as input parameter
Mark Transaction Detail process as Failed. Retry request with proper parameter
4041301Transaction Not Found
Transaction not found
Mark Transaction Detail process as Failed. Retry request periodically
4291300Too Many Requests
Maximum transaction limit exceeded
Mark Transaction Detail process as Failed. Retry request periodically
5001300General Error
General error non retry-able
Mark Transaction Detail process as Failed. Retry request periodically
5001301Internal Server Error
Unknown internal server failure, please retry the process again
Mark Transaction Detail process as Failed. Retry request periodically
Total Timeout
Total timeout, the client side does not get any responses from the server side (can be due to network issue, server slowing down, and so on)
Do a retry maximum 3 attempts, if still fails mark Transaction Detail process as Failed
Unexpected response (empty field/field does not exist/undefined response code)
The server does not produce expected responses (can be due to hardware failure, bugs, and so on)
  • If the response code prefix are 202 and 5XX, mark Transaction Detail process as Failed
  • If empty field/field does not exist, mark Transaction Detail process as Failed
ask AIAI Assistant
Need help with our documentation?
Start from our frequently asked questions or feel free to ask anything else.

AI generated responses may contain mistakes.