Skip to main content

Create BSB/Account Number Payment

POST 

https://api.cleverhub.co/api/v1/merchants/create_bank_payment

Initiate a payment request to a BSB and account number by specifying the amount, customer details, and additional attributes. This endpoint supports only Australian Dollar (AUD) payments. Transactions will be rejected if any of the required fields, such as Account Name, BSB Number, Account Number, Description, or Amount, are incorrect or missing.

This payment method provides flexibility in sending funds directly to Australian bank accounts, ideal for merchants needing BSB and account number transfers.

Request

Bodyrequired

    namestringrequired

    The full name of the customer for whom the payment is being created.

    Possible values: Value must match regular expression ^(?![! ](?![!]*$))[a-zA-Z0-9 ]*(?![ ])$

    Example: Jane Doe
    gstbooleanrequired

    Indicates whether Goods and Services Tax (GST) applies to the payment (for Australian merchants).

    Example: true
    amountnumberrequired

    The total amount to be charged, specified in Australian Dollars (AUD).

    Example: 1000
    descriptionstringrequired

    A brief description of the purpose of the payment.

    Possible values: Value must match regular expression ^(?![! ](?![!]*$))[a-zA-Z0-9 _-]*(?![ ])$

    Example: Payment for invoice #1234
    emailsstringrequired

    Comma-separated list of email addresses for notifications. Only lowercase letters are allowed.

    Possible values: Value must match regular expression ^([a-z0-9_\-\.]+)@([a-z]+)\.([a-z]+)(,[a-z0-9_\-\.]+@[a-z]+\.([a-z]+))*$

    Example: customer@example.com
    expired_atdate-time

    Expiration date and time of the payment, in UTC. Must be at least 15 minutes from the current time.

    Example: 2024-12-31T23:59:59Z
    external_idstring

    A custom identifier provided by the merchant for tracking purposes.

    Example: custom-id-12345
    payment_request_notification objectrequired

    Callback configuration for receiving payment status updates.

    endpoint_urlurirequired

    The publicly accessible URL where Hello Clever will send payment status updates.

    Example: https://example.com/payment_callback
    authorization_headerstringrequired

    The value of the Authorization header used in the callback request for added security.

    Example: Bearer your_token

Responses

Payment request created successfully.

Schema
    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

Callbacks

POST 

{$request.body#/payment_request_notification.endpoint_url}

Bodyrequired

    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

Callbacks Responses

Callback received successfully.

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`.
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.cleverhub.co/api/v1/merchants/create_bank_payment");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("app-id", "<app-id>");
request.Headers.Add("secret-key", "<app-id>");
var content = new StringContent("{\n \"name\": \"Jane Doe\",\n \"gst\": true,\n \"amount\": 1000,\n \"description\": \"Payment for invoice #1234\",\n \"emails\": \"customer@example.com\",\n \"expired_at\": \"2024-12-31T23:59:59Z\",\n \"external_id\": \"custom-id-12345\",\n \"payment_request_notification\": {\n \"endpoint_url\": \"https://example.com/payment_callback\",\n \"authorization_header\": \"Bearer your_token\"\n }\n}", null, "application/json");
request.Content = content;
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
Body required
{
  "name": "Jane Doe",
  "gst": true,
  "amount": 1000,
  "description": "Payment for invoice #1234",
  "emails": "customer@example.com",
  "expired_at": "2024-12-31T23:59:59Z",
  "external_id": "custom-id-12345",
  "payment_request_notification": {
    "endpoint_url": "https://example.com/payment_callback",
    "authorization_header": "Bearer your_token"
  }
}
ResponseClear

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