AUD PayID

Create One-Time PayID

Generate a unique, one-time-use PayID for processing a single payment transaction. This endpoint creates a secure PayID that the customer can use to complete a payment, allowing merchants to receive funds directly.

Once a payment is initiated, the payment_request_notification object can be configured to provide real-time status updates via a callback to a specified endpoint, ensuring that merchants receive notifications for every change in the transaction’s status.

POST

merchants

create_payment

Create One-Time PayID

curl --request POST \
  --url https://api.cleverhub.co/api/v1/merchants/create_payment \
  --header 'Content-Type: application/json' \
  --header 'app-id: <api-key>' \
  --header 'secret-key: <api-key>' \
  --data '
{
  "name": "John Doe",
  "gst": true,
  "amount": 100,
  "description": "Payment for invoice #1234",
  "emails": "customer@example.com",
  "payment_request_notification": {
    "endpoint_url": "https://example.com/payment_callback",
    "authorization_header": "Bearer your_token"
  },
  "prefix_static_payid": "abc",
  "expired_at": "2024-12-31T23:59:59Z",
  "external_id": "custom-id-12345"
}
'

import requests

url = "https://api.cleverhub.co/api/v1/merchants/create_payment"

payload = {
    "name": "John Doe",
    "gst": True,
    "amount": 100,
    "description": "Payment for invoice #1234",
    "emails": "customer@example.com",
    "payment_request_notification": {
        "endpoint_url": "https://example.com/payment_callback",
        "authorization_header": "Bearer your_token"
    },
    "prefix_static_payid": "abc",
    "expired_at": "2024-12-31T23:59:59Z",
    "external_id": "custom-id-12345"
}
headers = {
    "app-id": "<api-key>",
    "secret-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'app-id': '<api-key>',
    'secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'John Doe',
    gst: true,
    amount: 100,
    description: 'Payment for invoice #1234',
    emails: 'customer@example.com',
    payment_request_notification: {
      endpoint_url: 'https://example.com/payment_callback',
      authorization_header: 'Bearer your_token'
    },
    prefix_static_payid: 'abc',
    expired_at: '2024-12-31T23:59:59Z',
    external_id: 'custom-id-12345'
  })
};

fetch('https://api.cleverhub.co/api/v1/merchants/create_payment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cleverhub.co/api/v1/merchants/create_payment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'John Doe',
    'gst' => true,
    'amount' => 100,
    'description' => 'Payment for invoice #1234',
    'emails' => 'customer@example.com',
    'payment_request_notification' => [
        'endpoint_url' => 'https://example.com/payment_callback',
        'authorization_header' => 'Bearer your_token'
    ],
    'prefix_static_payid' => 'abc',
    'expired_at' => '2024-12-31T23:59:59Z',
    'external_id' => 'custom-id-12345'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "app-id: <api-key>",
    "secret-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cleverhub.co/api/v1/merchants/create_payment"

	payload := strings.NewReader("{\n  \"name\": \"John Doe\",\n  \"gst\": true,\n  \"amount\": 100,\n  \"description\": \"Payment for invoice #1234\",\n  \"emails\": \"customer@example.com\",\n  \"payment_request_notification\": {\n    \"endpoint_url\": \"https://example.com/payment_callback\",\n    \"authorization_header\": \"Bearer your_token\"\n  },\n  \"prefix_static_payid\": \"abc\",\n  \"expired_at\": \"2024-12-31T23:59:59Z\",\n  \"external_id\": \"custom-id-12345\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("app-id", "<api-key>")
	req.Header.Add("secret-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cleverhub.co/api/v1/merchants/create_payment")
  .header("app-id", "<api-key>")
  .header("secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"John Doe\",\n  \"gst\": true,\n  \"amount\": 100,\n  \"description\": \"Payment for invoice #1234\",\n  \"emails\": \"customer@example.com\",\n  \"payment_request_notification\": {\n    \"endpoint_url\": \"https://example.com/payment_callback\",\n    \"authorization_header\": \"Bearer your_token\"\n  },\n  \"prefix_static_payid\": \"abc\",\n  \"expired_at\": \"2024-12-31T23:59:59Z\",\n  \"external_id\": \"custom-id-12345\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cleverhub.co/api/v1/merchants/create_payment")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["app-id"] = '<api-key>'
request["secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"John Doe\",\n  \"gst\": true,\n  \"amount\": 100,\n  \"description\": \"Payment for invoice #1234\",\n  \"emails\": \"customer@example.com\",\n  \"payment_request_notification\": {\n    \"endpoint_url\": \"https://example.com/payment_callback\",\n    \"authorization_header\": \"Bearer your_token\"\n  },\n  \"prefix_static_payid\": \"abc\",\n  \"expired_at\": \"2024-12-31T23:59:59Z\",\n  \"external_id\": \"custom-id-12345\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 123456,
  "balance_id": "HDCHJSS",
  "name": "John Doe",
  "request_payid": "payid123@example.com",
  "merchant_name": "Merchant Co.",
  "gst": true,
  "amount": "100.0",
  "total": "110.0",
  "gst_amount": "10.0",
  "expired_at": "2024-12-31T23:59:59Z",
  "external_id": "custom-id-12345",
  "cashback_amount": "5.0",
  "pay_by": "2024-12-30T23:59:59Z",
  "paid_at": "2024-12-25T12:34:56Z",
  "status": "pending",
  "description": "Payment for invoice #1234",
  "nonce": "unique_nonce_string",
  "stage": "overpaid",
  "refund_information": {
    "refund_payid": "sample@payid.com",
    "refund_amount": 0.1,
    "request_date": "2024-12-31T23:59:59Z",
    "reason": "Broken product"
  },
  "sender_details": {
    "reference": "SenderRef123",
    "description": "Payment from John Doe",
    "bsb": "123456",
    "account_number": "987654321",
    "account_name": "John Doe"
  },
  "short_invoice_url": "https://short.example.com/invoice/123456",
  "invoice_url": "https://example.com/invoice/123456"
}

Authorizations

app-id

string

header

required

A unique identifier assigned to each application.

secret-key

string

header

required

A secure token associated with the app-id.

Body

application/json

name

string

required

Customer's full name.

Example:

"John Doe"

gst

boolean

required

Indicates if Goods and Services Tax (GST) applies for Australian merchants.

Example:

true

amount

number

required

The total payment amount for the transaction in AUD.

Example:

100

description

string

required

Brief description of the payment purpose.

Example:

"Payment for invoice #1234"

emails

string

required

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

Pattern: ^([a-z0-9_\-\.]+)@([a-z]+)\.([a-z]+)(,[a-z0-9_\-\.]+@[a-z]+\.([a-z]+))*$

Example:

"customer@example.com"

payment_request_notification

object

required

Details for merchant callback notifications when the payment status changes.

Show child attributes

prefix_static_payid

string

deprecated

Static prefix for the PayID, used to generate a PayID in the format prefix_static_payid@example.co.

Pattern: ^(?=[a-z0-9]{3,35}$)[a-z0-9]*$

Example:

"abc"

expired_at

string<date-time>

Expiration time of the PayID in UTC format. Should be at least 15 minutes from the current time.

Example:

"2024-12-31T23:59:59Z"

external_id

string

Custom identifier for tracking purposes, set by the merchant.

Example:

"custom-id-12345"

Callbacks

POST

{$request.body#/payment_request_notification.endpoint_url}statusChange

Body

application/json

integer

A unique identifier assigned to the payment request, used for tracking and referencing purposes within the system.

Example:

123456

balance_id

string

The identifier of the balance associated with this payment request, allowing for account management and tracking of specific transactions.

Example:

"HDCHJSS"

name

string

The name of the individual or entity associated with the payment request. This helps identify the payer or payee involved.

Example:

"John Doe"

request_payid

string

The PayID generated for the payment request, used to uniquely identify and route the payment to the correct recipient.

Example:

"payid123@example.com"

merchant_name

string

The name of the merchant managing or handling the payment. This field is useful for recognising the party to whom the payment is being made.

Example:

"Merchant Co."

gst

boolean

Indicates whether Goods and Services Tax (GST) applies to the transaction. A value of true means GST is included.

Example:

true

amount

string

The amount requested for the payment, excluding any applicable taxes. This field represents the base value of the transaction.

Example:

"100.0"

total

string

The total amount due, including all applicable taxes such as GST. This is the final amount the payer needs to pay.

Example:

"110.0"

gst_amount

string

The portion of the total amount that is attributable to GST. This helps in breaking down the tax components of the payment.

Example:

"10.0"

expired_at

string<date-time>

The expiration date and time of the PayID, indicating until when the PayID is valid for making the payment.

Example:

"2024-12-31T23:59:59Z"

external_id

string

A custom identifier provided for tracking purposes, such as an internal reference or an invoice number.

Example:

"custom-id-12345"

cashback_amount

string

The cashback amount, if applicable, that the payer is eligible to receive as part of the transaction.

Example:

"5.0"

pay_by

string<date-time>

The last date by which the payment must be made. This provides a clear deadline for the payer.

Example:

"2024-12-30T23:59:59Z"

paid_at

string<date-time>

The date and time when the payment was successfully completed. This is used for record-keeping and verification.

Example:

"2024-12-25T12:34:56Z"

status

enum<string>

The current status of the payment request. Possible values include:

pending: The payment request is still open and awaiting payment.
received: The payment has been received.
expired: The payment request has expired.
return_pending: A return of funds is in process.
return_received: Returned funds have been received.
return_expired: The return process has expired.
return_rejected: The return request was rejected.

Available options:

pending,

received,

expired,

return_pending,

return_received,

return_expired,

return_rejected

Example:

"pending"

description

string

A description accompanying the payment request, providing additional information such as the purpose of the payment or related invoice details.

Example:

"Payment for invoice #1234"

nonce

string

A unique value used to validate the transaction, preventing replay attacks and ensuring the integrity of the payment request.

Example:

"unique_nonce_string"

stage

enum<string>

Represents the specific stage within the pending status. This value is null unless the transaction is flagged for being overpaid, underpaid, or having an unmatched nonce.

Available options:

overpaid,

underpaid,

unmatched_nonce,

null

Example:

"overpaid"

refund_information

object

Details about any refunds that are associated with this payment. This includes information about the refund PayID, refund amount, and any reasons provided.

Show child attributes

sender_details

object

Information about the sender of the payment, including reference details, bank information, and account holder's name.

Show child attributes

short_invoice_url

string<uri>

deprecated

A shortened version of the invoice URL for convenience. This can be used to quickly share or access the invoice details. Note: this field is deprecated.

Example:

"https://short.example.com/invoice/123456"

invoice_url

string<uri>

deprecated

The full URL of the invoice related to the payment request. This provides access to the detailed invoice online. Note: this field is deprecated.

Example:

"https://example.com/invoice/123456"

Response

Callback received successfully.

Response

Payment request created successfully.

integer

A unique identifier assigned to the payment request, used for tracking and referencing purposes within the system.

Example:

123456

balance_id

string

The identifier of the balance associated with this payment request, allowing for account management and tracking of specific transactions.

Example:

"HDCHJSS"

name

string

The name of the individual or entity associated with the payment request. This helps identify the payer or payee involved.

Example:

"John Doe"

request_payid

string

The PayID generated for the payment request, used to uniquely identify and route the payment to the correct recipient.

Example:

"payid123@example.com"

merchant_name

string

The name of the merchant managing or handling the payment. This field is useful for recognising the party to whom the payment is being made.

Example:

"Merchant Co."

gst

boolean

Indicates whether Goods and Services Tax (GST) applies to the transaction. A value of true means GST is included.

Example:

true

amount

string

The amount requested for the payment, excluding any applicable taxes. This field represents the base value of the transaction.

Example:

"100.0"

total

string

The total amount due, including all applicable taxes such as GST. This is the final amount the payer needs to pay.

Example:

"110.0"

gst_amount

string

The portion of the total amount that is attributable to GST. This helps in breaking down the tax components of the payment.

Example:

"10.0"

expired_at

string<date-time>

The expiration date and time of the PayID, indicating until when the PayID is valid for making the payment.

Example:

"2024-12-31T23:59:59Z"

external_id

string

A custom identifier provided for tracking purposes, such as an internal reference or an invoice number.

Example:

"custom-id-12345"

cashback_amount

string

The cashback amount, if applicable, that the payer is eligible to receive as part of the transaction.

Example:

"5.0"

pay_by

string<date-time>

The last date by which the payment must be made. This provides a clear deadline for the payer.

Example:

"2024-12-30T23:59:59Z"

paid_at

string<date-time>

The date and time when the payment was successfully completed. This is used for record-keeping and verification.

Example:

"2024-12-25T12:34:56Z"

status

enum<string>

The current status of the payment request. Possible values include:

pending: The payment request is still open and awaiting payment.
received: The payment has been received.
expired: The payment request has expired.
return_pending: A return of funds is in process.
return_received: Returned funds have been received.
return_expired: The return process has expired.
return_rejected: The return request was rejected.

Available options:

pending,

received,

expired,

return_pending,

return_received,

return_expired,

return_rejected

Example:

"pending"

description

string

A description accompanying the payment request, providing additional information such as the purpose of the payment or related invoice details.

Example:

"Payment for invoice #1234"

nonce

string

A unique value used to validate the transaction, preventing replay attacks and ensuring the integrity of the payment request.

Example:

"unique_nonce_string"

stage

enum<string>

Represents the specific stage within the pending status. This value is null unless the transaction is flagged for being overpaid, underpaid, or having an unmatched nonce.

Available options:

overpaid,

underpaid,

unmatched_nonce,

null

Example:

"overpaid"

refund_information

object

Details about any refunds that are associated with this payment. This includes information about the refund PayID, refund amount, and any reasons provided.

Show child attributes

sender_details

object

Information about the sender of the payment, including reference details, bank information, and account holder's name.

Show child attributes

short_invoice_url

string<uri>

deprecated

A shortened version of the invoice URL for convenience. This can be used to quickly share or access the invoice details. Note: this field is deprecated.

Example:

"https://short.example.com/invoice/123456"

invoice_url

string<uri>

deprecated

The full URL of the invoice related to the payment request. This provides access to the detailed invoice online. Note: this field is deprecated.

Example:

"https://example.com/invoice/123456"

Create Payment Gateway Link

Create Static PayID

Create One-Time PayID

curl --request POST \
  --url https://api.cleverhub.co/api/v1/merchants/create_payment \
  --header 'Content-Type: application/json' \
  --header 'app-id: <api-key>' \
  --header 'secret-key: <api-key>' \
  --data '
{
  "name": "John Doe",
  "gst": true,
  "amount": 100,
  "description": "Payment for invoice #1234",
  "emails": "customer@example.com",
  "payment_request_notification": {
    "endpoint_url": "https://example.com/payment_callback",
    "authorization_header": "Bearer your_token"
  },
  "prefix_static_payid": "abc",
  "expired_at": "2024-12-31T23:59:59Z",
  "external_id": "custom-id-12345"
}
'

import requests

url = "https://api.cleverhub.co/api/v1/merchants/create_payment"

payload = {
    "name": "John Doe",
    "gst": True,
    "amount": 100,
    "description": "Payment for invoice #1234",
    "emails": "customer@example.com",
    "payment_request_notification": {
        "endpoint_url": "https://example.com/payment_callback",
        "authorization_header": "Bearer your_token"
    },
    "prefix_static_payid": "abc",
    "expired_at": "2024-12-31T23:59:59Z",
    "external_id": "custom-id-12345"
}
headers = {
    "app-id": "<api-key>",
    "secret-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'app-id': '<api-key>',
    'secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'John Doe',
    gst: true,
    amount: 100,
    description: 'Payment for invoice #1234',
    emails: 'customer@example.com',
    payment_request_notification: {
      endpoint_url: 'https://example.com/payment_callback',
      authorization_header: 'Bearer your_token'
    },
    prefix_static_payid: 'abc',
    expired_at: '2024-12-31T23:59:59Z',
    external_id: 'custom-id-12345'
  })
};

fetch('https://api.cleverhub.co/api/v1/merchants/create_payment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cleverhub.co/api/v1/merchants/create_payment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'John Doe',
    'gst' => true,
    'amount' => 100,
    'description' => 'Payment for invoice #1234',
    'emails' => 'customer@example.com',
    'payment_request_notification' => [
        'endpoint_url' => 'https://example.com/payment_callback',
        'authorization_header' => 'Bearer your_token'
    ],
    'prefix_static_payid' => 'abc',
    'expired_at' => '2024-12-31T23:59:59Z',
    'external_id' => 'custom-id-12345'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "app-id: <api-key>",
    "secret-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cleverhub.co/api/v1/merchants/create_payment"

	payload := strings.NewReader("{\n  \"name\": \"John Doe\",\n  \"gst\": true,\n  \"amount\": 100,\n  \"description\": \"Payment for invoice #1234\",\n  \"emails\": \"customer@example.com\",\n  \"payment_request_notification\": {\n    \"endpoint_url\": \"https://example.com/payment_callback\",\n    \"authorization_header\": \"Bearer your_token\"\n  },\n  \"prefix_static_payid\": \"abc\",\n  \"expired_at\": \"2024-12-31T23:59:59Z\",\n  \"external_id\": \"custom-id-12345\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("app-id", "<api-key>")
	req.Header.Add("secret-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cleverhub.co/api/v1/merchants/create_payment")
  .header("app-id", "<api-key>")
  .header("secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"John Doe\",\n  \"gst\": true,\n  \"amount\": 100,\n  \"description\": \"Payment for invoice #1234\",\n  \"emails\": \"customer@example.com\",\n  \"payment_request_notification\": {\n    \"endpoint_url\": \"https://example.com/payment_callback\",\n    \"authorization_header\": \"Bearer your_token\"\n  },\n  \"prefix_static_payid\": \"abc\",\n  \"expired_at\": \"2024-12-31T23:59:59Z\",\n  \"external_id\": \"custom-id-12345\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cleverhub.co/api/v1/merchants/create_payment")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["app-id"] = '<api-key>'
request["secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"John Doe\",\n  \"gst\": true,\n  \"amount\": 100,\n  \"description\": \"Payment for invoice #1234\",\n  \"emails\": \"customer@example.com\",\n  \"payment_request_notification\": {\n    \"endpoint_url\": \"https://example.com/payment_callback\",\n    \"authorization_header\": \"Bearer your_token\"\n  },\n  \"prefix_static_payid\": \"abc\",\n  \"expired_at\": \"2024-12-31T23:59:59Z\",\n  \"external_id\": \"custom-id-12345\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 123456,
  "balance_id": "HDCHJSS",
  "name": "John Doe",
  "request_payid": "payid123@example.com",
  "merchant_name": "Merchant Co.",
  "gst": true,
  "amount": "100.0",
  "total": "110.0",
  "gst_amount": "10.0",
  "expired_at": "2024-12-31T23:59:59Z",
  "external_id": "custom-id-12345",
  "cashback_amount": "5.0",
  "pay_by": "2024-12-30T23:59:59Z",
  "paid_at": "2024-12-25T12:34:56Z",
  "status": "pending",
  "description": "Payment for invoice #1234",
  "nonce": "unique_nonce_string",
  "stage": "overpaid",
  "refund_information": {
    "refund_payid": "sample@payid.com",
    "refund_amount": 0.1,
    "request_date": "2024-12-31T23:59:59Z",
    "reason": "Broken product"
  },
  "sender_details": {
    "reference": "SenderRef123",
    "description": "Payment from John Doe",
    "bsb": "123456",
    "account_number": "987654321",
    "account_name": "John Doe"
  },
  "short_invoice_url": "https://short.example.com/invoice/123456",
  "invoice_url": "https://example.com/invoice/123456"
}

Overview

Payment Gateway (AUD)

Multi-currency Payment APIs

Multi-currency Gateway

Card API

Cashback API

Create One-Time PayID

Authorizations

Body

Callbacks

Body

Response

Response