Singapay Home Page
Logo Icon
  1. Transaction
  2. Histories

Information

MethodPathFormatAuthentication
GET/api/v1.0/transactions/{account_id}jsonOAuth 2.0 with Access Token

Request Details

Headers Structure

FieldValueTypeMandatoryLengthDescriptionExample
X-PARTNER-IDapi_keyAlphanumericMandatoryAPI key obtained from the merchant dashboard.b3ed7d4b-a96c-6c08-b3c7-12c3124242d9
Acceptapplication/jsonAlphabeticMandatorySpecifies JSON as the expected response format.application/json
AuthorizationBearer {bearerToken}AlphanumericMandatoryBearer token obtained from the get access token endpoint.Bearer eyJ0eXAiOiJKV1{…}

Body Structure

FieldValueTypeMandatoryLengthDescriptionExample
page{pageNumber}NumericOptional--2
start_date{startDate}DateOptional-Date format: YYYY-MM-DD2024-04-01
end_date{endDate}DateOptional-Date format: YYYY-MM-DD2024-04-30

Body Example

{
  "page": 2,
  "start_date": "2024-04-01",
  "end_date": "2024-04-30"
}

Response Details

Response Structure

FieldTypeMandatoryLengthDescriptionExample
statusNumericMandatory3HTTP Status Code200
successBooleanMandatory12xx is true. 4xx-500 is false.true
dataArray ObjectConditional---
> transaction_idNumericMandatory-Transaction id3645345
> accountObject----
>> nameAlphabetic----
>> idNumeric----
> bank_codeAlphabeticMandatory-Code of bank like: BRI, BNI, DANAMON, etcBRI
> va_numberNumericMandatory-Virtual_account bank number5588804221231232
> statusAlphabeticMandatory-Transaction status. Value filled by paid, pending, unpaidpaid
> amountObjectMandatory-Amount of transaction99000
>> valueDecimal----
>> currencyAlphabetic----
> feesArray----
>> nameAlphabetic----
>> amountDecimal----
>> currencyAlphabetic----
> total_amountDecimal----
>> valueDecimal----
>> currencyAlphabetic----
> post_timestampTimestampMandatory-Date requested with Unix Timestamp millisecond format1714122259
> processed_timestampTimestamp--Date finished with Unix Timestamp millisecond format-
> balance_afterNumericMandatory-Balance account after transaction99000
>> valueNumericMandatory--99000
>> currencyAlphabeticMandatory3-IDR
> additional_infoObject----
>> start_dateDate--Search start date with format YYYY-MM-DD-
>> end_dateDate--Search end date with format YYYY-MM-DD-
> paginationObject----
>> countNumeric----
>> totalNumeric----
>> perPageNumeric----
>> currentPageNumeric----
>> totalPagesNumeric----
>> linksObject----

Response Example

Success: Here’s an example of a successful response.

{
  "status": 200,
  "success": true,
  "data": [
    {
      "transaction_id": "645345445",
      "account": {
        "name": "Julian Pratama",
        "id": "465454"
      },
      "bank_code": "BRI",
      "va_number": "5588804221231232",
      "status": "paid",
      "notes": "lorem ipsum",
      "amount": {
        "value": "11000.00",
        "currency": "IDR"
      },
      "fees": [
        {
          "name": "Service Fee",
          "amount": "2000.00",
          "currency": "IDR"
        }
      ],
      "total_amount": {
        "value": "13000.00",
        "currency": "IDR"
      },
      "post_timestamp": "1714618220440",
      "processed_timestamp": "1714618220440",
      "balance_after": {
        "value": "11000.00",
        "currency": "IDR"
      }
    }
  ],
  "additional_info": {
    "start_date": "2024-04-01",
    "end_date": "2024-04-30"
  },
  "pagination": {
    "count": 1,
    "total": 1,
    "perPage": 10,
    "currentPage": 1,
    "totalPages": 1,
    "links": {}
  }
}

Error: This is an example of an unsuccessful request.

{
    "status": 401,
    "success": false,
    "error": {
        "code": 401,
        "message": "Unauthorized partner, please sign in"
    }
}