Get Payment Request List

GET 
https://api.cleverhub.co/api/v1/payment_requests/bank_payments

Retrieve a list of bank payment requests within a specified time period, up to a maximum of 1 year. This endpoint enables you to track and manage transactions by querying records based on a start (from_date) and end date (to_date). For queries beyond the 1-year limit, please contact our support team for assistance.

Pagination is supported, with up to 20 records returned per page, allowing you to browse through large datasets efficiently.

Request

Query Parameters

from_date date-timerequired
The start date for querying payment requests, formatted as 'DD/MM/YY' or 'YYYY-MM-DDThh:mm:ss' in UTC timezone.
Example: 2022-01-01T00:00:00
to_date date-timerequired
The end date for querying payment requests, formatted as 'DD/MM/YY' or 'YYYY-MM-DDThh:mm:ss' in UTC timezone.
Example: 2022-12-31T23:59:59
page integer
Page number to retrieve. Each page contains up to 20 records.
Example: 1

Responses

200

Payment request list retrieved successfully.

application/json

Schema

Schema

per_pageinteger
The number of records displayed per page.
Example: 20
pageinteger
The current page number being viewed.
Example: 1
total_pageinteger
The total number of pages available.
Example: 5
records object[]
Array [
idinteger
The unique identifier of the payment, used for tracking purposes.
Example: 12345
payee_detail object
Details of the payee's bank account, including BSB and account number, to facilitate the payment.
account_holder_namestringrequired
The name of the account holder for the payment. This helps ensure the correct payee is identified.
Example: Jane Doe
bsbstringrequired
The BSB (Bank-State-Branch) number used to facilitate the payment, identifying the bank and branch.
Example: 654321
account_numberstringrequired
The account number used to make the payment, providing the unique identifier of the payee's account.
Example: 987654321
namestring
The name of the customer associated with the payment request.
Example: Jane Doe
merchant_namestring
The name of the merchant handling the payment request, allowing identification of the party being paid.
Example: Merchant Inc.
gstboolean
Indicates whether GST (Goods and Services Tax) is applicable to the payment. A value of true indicates GST is included.
Example: true
amountstring
The amount for the payment, excluding GST. This represents the base transaction value.
Example: 1000.0
totalstring
The total payment amount, including GST. This is the final amount to be paid by the customer.
Example: 1100.0
gst_amountstring
The portion of the total amount that represents GST. This helps break down the tax component.
Example: 100.0
expired_atdate-time
The expiration date and time of the payment request, indicating the deadline for making the payment.
Example: 2024-12-31T23:59:59Z
external_idstring
A custom identifier used for tracking purposes, such as an invoice or reference number provided by the user.
Example: custom-id-12345
cashback_amountstring
The cashback amount offered as part of the transaction, if applicable.
Example: 50.0
pay_bydate-time
The deadline by which the payment must be completed, providing a clear due date.
Example: 2024-12-30T23:59:59Z
paid_atdate-time
The date and time when the payment was successfully made, used for record-keeping.
Example: 2024-12-25T12:34:56Z
statusstring
The current status of the payment request. Possible values include:
• pending: Awaiting payment.
• received: Payment completed.
• expired: Payment request expired.
• return_pending: Refund process initiated.
• return_received: Refund completed.
• return_expired: Refund request expired.
• return_rejected: Refund request rejected.
Possible values: [pending, received, expired, return_pending, return_received, return_expired, return_rejected]
Example: received
descriptionstring
A description associated with the payment request, providing context or additional details about the transaction.
Example: Payment for invoice #1234
refund_information object
Details of any refund associated with the payment, including bank details and refund amount.
refund_bsbstring
The BSB number used for the refund, identifying the bank involved.
Example: 654321
refund_account_numberstring
The account number used for the refund, providing the destination for refunded funds.
Example: 987654321
refund_amountstring
The amount refunded to the payee, providing clarity on the value being returned.
Example: 10.99
request_datedate-time
The date when the refund was requested, used for record-keeping.
Example: 2024-07-01T00:00:00Z
reasonstring
The reason for the refund, providing context such as incorrect payment or product issues.
Example: Refund for incorrect payment
payment_request_notification object
Details of the merchant's callback settings, including the endpoint URL and authorization information for receiving payment status updates.
endpoint_urluri
The URL to which payment status updates will be sent by the system, allowing the merchant to receive notifications.
Example: https://merchant.com/payment_callback
authorization_headerstring
The authorization header value used in the callback request, helping to ensure the request is authenticated.
Example: Bearer your_token
noncestring
A nonce value used to validate the transaction, ensuring that it is unique and preventing replay attacks.
Example: unique_nonce_string
stagestring
Represents the specific stage in a pending transaction. Default value is null unless the payment amount is incorrect or the nonce is unmatched.
Possible values: [overpaid, underpaid, unmatched_nonce, null]
Example: overpaid
additional_propertystring
A new property added to the BSBAccountObject for extended functionality or specific use cases.
Example: Additional value
]

Example (auto)

{
  "per_page": 20,
  "page": 1,
  "total_page": 5,
  "records": [
    {
      "id": 12345,
      "payee_detail": {
        "account_holder_name": "Jane Doe",
        "bsb": "654321",
        "account_number": "987654321"
      },
      "name": "Jane Doe",
      "merchant_name": "Merchant Inc.",
      "gst": true,
      "amount": "1000.0",
      "total": "1100.0",
      "gst_amount": "100.0",
      "expired_at": "2024-12-31T23:59:59Z",
      "external_id": "custom-id-12345",
      "cashback_amount": "50.0",
      "pay_by": "2024-12-30T23:59:59Z",
      "paid_at": "2024-12-25T12:34:56Z",
      "status": "received",
      "description": "Payment for invoice #1234",
      "refund_information": {
        "refund_bsb": "654321",
        "refund_account_number": "987654321",
        "refund_amount": "10.99",
        "request_date": "2024-07-01T00:00:00Z",
        "reason": "Refund for incorrect payment"
      },
      "payment_request_notification": {
        "endpoint_url": "https://merchant.com/payment_callback",
        "authorization_header": "Bearer your_token"
      },
      "nonce": "unique_nonce_string",
      "stage": "overpaid",
      "additional_property": "Additional value"
    }
  ]
}

400

Bad Request

401

Unauthorized

Authorization: app-id

name: app-idtype: apiKeyin: headerdescription: A unique identifier assigned to each application.

name: secret-keytype: apiKeyin: headerdescription: A secure token associated with the `app-id`.

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.cleverhub.co/api/v1/payment_requests/bank_payments");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("app-id", "<app-id>");
request.Headers.Add("secret-key", "<app-id>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://api.cleverhub.co/api

Auth

app-id

secret-key

Parameters

from_date — queryrequired

to_date — queryrequired

page — query

ResponseClear

Click the Send API Request button above and see the response here!