Disbursement

Bank Statement

Bank Statement is a service that allows you to access a comprehensive transaction history.
Type Value
Service Code
14
Name
API Bank Statement
HTTP Method
POST

Flow

You send the required parameters to make a request, and Espay Disbursement will respond in JSON format.

API URL

Environment URL
Sandbox
Port of HTTPS (443)
https://sandbox-api.espay.id/api/v1.0/bank-statement
Production
Port of HTTPS (443)
https://api.espay.id/api/v1.0/bank-statement

Headers

Name Type Mandatory Description
Content-Type
String
Y
Content of your request body.

Example:
application/json
X-TIMESTAMP
String (25)
Y
Customer's current local date and time.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Example:
2024-03-14T07:49:28+07:00
X-SIGNATURE
String (255)
Y
Code used to validate transactions. Learn Disbursement | Asymmetric Signature.
X-EXTERNAL-ID
String (32)
Y
Numeric String. Reference number that should be unique on the same day.
X-PARTNER-ID
String (50)
Y
Merchant Code from Espay team.

Example:
SGWYESSISHOP
CHANNEL-ID
String (5)
Y
Channel id.

Value:
Espay
Authorization-Customer
String
Y
Access Token from B2B. Learn B2B Access Token.

Format:
Bearer (access token).

Example:
Bearer ZDE1MTQxM2QwODE2Zj UyNjk3ZmY0NTA3ZDgwZ Tg2ZDcyNmQ4MTNlYw
Y: Yes, O: Optional, C: Conditional

Request Parameters

Parameter Type Mandatory Description
partnerReferenceNo
String (64)
Y
Unique reference code from merchant.
accountNo
String (16)
Y
Source account number.
fromDateTime
String (25)
Y
Start time range.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Example:
2024-03-14T07:49:28+07:00
toDateTime
String (25)
Y
End time range.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Example:
2024-03-14T07:49:28+07:00
Y: Yes, O: Optional, C: Conditional

Response Parameters

Parameter Type Mandatory Description
responseCode
String (7)
Y
Response code. See response codes here.

Format:
HTTP code + Service code + Error code

Example:
200+14+00 = 2001400.
responseMessage
String (150)
Y
Response description.
referenceNo
String (16)
Y
Reference code from bank.
partneReferenceNo
String (64)
Y
Unique reference code from merchant.
balance
Array of Object
  amount
Array of Object
    value
String (16.2)
Y
Total net balance.

Format:
Decimal .00 (ISO 4217)

Example:
150000.00
    currency
String (3)
Y
Transaction currency code.

Format:
  • Rupiah: IDR
    dateTime
String (25)
Y
Date and time the balance was updated.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Example:
2022-08-21T14:45:28+07:00
  startingBalance
Array of Object
    value
String (16.2)
Y
Starting balance.

Format:
Decimal .00 (ISO 4217)

Example:
150000.00
    currency
String (3)
Y
Transaction currency code.

Format:
  • Rupiah: IDR
    dateTime
String (25)
Y
Date and time the balance was updated.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Example:
2022-08-21T14:45:28+07:00
  endingBalance
Array of Object
    value
String (16.2)
Y
Ending balance.

Format:
Decimal .00 (ISO 4217)

Example:
150000.00
    currency
String (3)
Y
Transaction currency code.

Format:
  • Rupiah: IDR
    dateTime
String (25)
Y
Date and time the balance was updated.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Example:
2022-08-21T14:45:28+07:00
totalCreditEntries
Array of Object
  numberOfEntries
String (5)
Y
Number of credit entries.
  amount
Array of Object
    value
String (16.2)
Y
Amount of credit.

Format:
Decimal .00 (ISO 4217)

Example:
150000.00
    currency
String (3)
Y
Transaction currency code.

Format:
  • Rupiah: IDR
totalDebitEntries
Array of Object
  numberOfEntries
String (5)
Y
Number of debit entries.
  amount
Array of Object
    value
String (16.2)
Y
Amount of debit.

Format:
Decimal .00 (ISO 4217)

Example:
150000.00
    currency
String (3)
Y
Transaction currency code.

Format:
  • Rupiah: IDR
detailData
Array of Object
  amount
Array of Object
    value
String (16.2)
Y
Amount of transction.

Format:
Decimal .00 (ISO 4217)

Example:
150000.00.00
    currency
String (3)
Y
Transaction currency code.

Format:
  • Rupiah: IDR
  transactionDate
String (25)
Y
Date and time of the transaction.

Format:
yyyy-MM- ddThh:mi:ssTZD (ISO 8601).

Example:
2022-08-21T14:56:11+07:00
  remark
String (255)
Y
Description.
  type
String (6)
Y
Type of transaction.

Format:
  • Tipe Kredit: CREDIT
  • Tipe Debit: DEBIT
Y: Yes, O: Optional, C: Conditional

Try It!

Anda bisa coba masukkan data sesuai dengan input yang telah disediakan. Setelah itu Anda submit dan lihat hasilnya!






























Sample Headers

Content-Type:application/json
X-TIMESTAMP:2024-10-08T07:49:28+07:00
X-SIGNATURE:xt6C9dzkF5jrYye7qmdC3IMxVBExqxg7ohBp+fOkImY7DlngZsLQhtimD3rtkno9N59VEoKrRLGr8QWL8DWaCQH+XGeBp4PR341IPy9b4ykYQ9R/IsjSL4J8N7bNMYi4VCA0Y+hRI9WJ8bF7BOY6yyT5l1OPl3vgBSG2UponBcpPG49PRaBrYHKhYn1WBTIc38l/PmGH2oH4zhE6/VkmQsMnvei2f2WhJHsYZA0NAIcD8hYG9DHkF1C6mirCE13Ia180pb9DULFhF+8POpbBssDidbqYhATmG5r98ZqkYULQw5StyOeGBm4JmpmzMTSBJ7NZ/LttPNirAbGM8p5YaQ==
X-EXTERNAL-ID:d3be5aec-155b-4b46-bfee-3fd55363d0f4
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY
Authorization:Bearer dPYxGvc5SSS8lETvpqRZ2hdM39fTNN3uhIZS5woAZb79ybGDDNAMeWVG2S7cp0USwx9TGcXN/0kzYGobeyzpdg==




































Sample Request

{
    "partnerReferenceNo": "4152435123422",
    "accountNo": "0613008753",
    "fromDateTime": "2024-01-11T00:00:00+07:00",
    "toDateTime": "2024-12-30T00:00:00+07:00"
}
















Sample Positive Response

{
    "responseCode": "2001400",
    "responseMessage": "Successful",
    "referenceNo": "4152435123422",
    "partnerReferenceNo": "4152435123422",
    "balance": [
        {
            "amount": {
                "value": "1008446241249.74",
                "currency": "IDR",
                "dateTime": "2024-10-01T11:16:40+07:00"
            },
            "startingBalance": {
                "value": "1008446230119.74",
                "currency": "IDR",
                "dateTime": "2024-10-04T00:37:59+07:00"
            },
            "endingBalance": {
                "value": "1008443245299.74",
                "currency": "IDR",
                "dateTime": "2024-10-01T11:16:40+07:00"
            }
        }
    ],
    "totalCreditEntries": {
        "numberOfEntries": "2",
        "amount": {
            "value": "22260.00",
            "currency": "IDR"
        }
    },
    "totalDebitEntries": {
        "numberOfEntries": "24",
        "amount": {
            "value": "3007080.00",
            "currency": "IDR"
        }
    },
    "detailData": [
        {
            "amount": {
                "value": "11130.00",
                "currency": "IDR"
            },
            "transactionDate": "2024-10-01T11:16:40+07:00",
            "remark": "TRSF E-BANKING CR 0906/FTSCY/WS95051 11130.00remark testPERUSAHAAN10",
            "type": "CREDIT"
        }
    ]
}


Sample Negative Response

{
    "responseCode": "4011401",
    "responseMessage": "Invalid Token (B2B)"
}


HTTP

POST /api/v1.0/bank-statement HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/json
X-TIMESTAMP: 2024-10-08T07:49:28+07:00
X-SIGNATURE: xt6C9dzkF5jrYye7qmdC3IMxVBExqxg7ohBp+fOkImY7DlngZsLQhtimD3rtkno9N59VEoKrRLGr8QWL8DWaCQH+XGeBp4PR341IPy9b4ykYQ9R/IsjSL4J8N7bNMYi4VCA0Y+hRI9WJ8bF7BOY6yyT5l1OPl3vgBSG2UponBcpPG49PRaBrYHKhYn1WBTIc38l/PmGH2oH4zhE6/VkmQsMnvei2f2WhJHsYZA0NAIcD8hYG9DHkF1C6mirCE13Ia180pb9DULFhF+8POpbBssDidbqYhATmG5r98ZqkYULQw5StyOeGBm4JmpmzMTSBJ7NZ/LttPNirAbGM8p5YaQ==
X-EXTERNAL-ID: d3be5aec-155b-4b46-bfee-3fd55363d0f4
X-PARTNER-ID: SGWYESSISHOP
CHANNEL-ID: ESPAY
Authorization: Bearer dPYxGvc5SSS8lETvpqRZ2hdM39fTNN3uhIZS5woAZb79ybGDDNAMeWVG2S7cp0USwx9TGcXN/0kzYGobeyzpdg==
Content-Length: 172

{
    "partnerReferenceNo": "4152435123422",
    "accountNo": "0613008753",
    "fromDateTime": "2024-01-11T00:00:00+07:00",
    "toDateTime": "2024-12-30T00:00:00+07:00"
}


CURL

curl --location 'https://sandbox-api.espay.id/api/v1.0/bank-statement' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2024-10-08T07:49:28+07:00' \
--header 'X-SIGNATURE: xt6C9dzkF5jrYye7qmdC3IMxVBExqxg7ohBp+fOkImY7DlngZsLQhtimD3rtkno9N59VEoKrRLGr8QWL8DWaCQH+XGeBp4PR341IPy9b4ykYQ9R/IsjSL4J8N7bNMYi4VCA0Y+hRI9WJ8bF7BOY6yyT5l1OPl3vgBSG2UponBcpPG49PRaBrYHKhYn1WBTIc38l/PmGH2oH4zhE6/VkmQsMnvei2f2WhJHsYZA0NAIcD8hYG9DHkF1C6mirCE13Ia180pb9DULFhF+8POpbBssDidbqYhATmG5r98ZqkYULQw5StyOeGBm4JmpmzMTSBJ7NZ/LttPNirAbGM8p5YaQ==' \
--header 'X-EXTERNAL-ID: d3be5aec-155b-4b46-bfee-3fd55363d0f4' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'CHANNEL-ID: ESPAY' \
--header 'Authorization: Bearer dPYxGvc5SSS8lETvpqRZ2hdM39fTNN3uhIZS5woAZb79ybGDDNAMeWVG2S7cp0USwx9TGcXN/0kzYGobeyzpdg==' \
--data '{
    "partnerReferenceNo": "4152435123422",
    "accountNo": "0613008753",
    "fromDateTime": "2024-01-11T00:00:00+07:00",
    "toDateTime": "2024-12-30T00:00:00+07:00"
}'
Scroll to Top