/paystack-commerce | Type: Application | PCID required: Yes
Tools
paystack_commerce_order_create
Create Order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
currency | string | Yes | — | Currency in which amount is set |
email | string | Yes | — | The email of the customer placing the order |
first_name | string | Yes | — | The customer’s first name |
is_gift | boolean | No | — | A flag to indicate if the order is for someone else |
items | object[] | Yes | — | The items value |
last_name | string | Yes | — | The customer’s last name |
pay_for_me | boolean | No | — | A flag to indicate if the someone else should pay for the order |
phone | string | Yes | — | The customer’s mobile number |
shipping | object | Yes | — | The shipping details of the order |
paystack_commerce_order_fetch
Fetch Order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the order |
paystack_commerce_order_list
List Orders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
perPage | integer | No | — | Number of records to fetch per page |
page | integer | No | — | The section to retrieve |
from | string | No | — | The start date |
to | string | No | — | The end date |
paystack_commerce_order_product
Fetch Product Orders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the product |
paystack_commerce_order_validate
Validate Order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The unique code of a previously created order |
paystack_commerce_page_add_products
Add Products Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The id value |
products | integer[] | Yes | — | A list of IDs of products to add to a page. |
paystack_commerce_page_check_slug_availability
Check Slug Availability Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
slug | string | Yes | — | The custom slug to check |
paystack_commerce_page_create
Create Page Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
amount | integer | No | — | Amount should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR |
collect_phone | boolean | No | — | Specify whether to collect phone numbers on the payment page |
currency | string | No | — | The transaction currency. Defaults to your integration currency. |
custom_fields | object[] | No | — | If you would like to accept custom fields, specify them here. |
description | string | No | — | The description of the page |
fixed_amount | boolean | No | — | Specifies whether to collect a fixed amount on the payment page. If true, amount must be passed. |
metadata | object | No | — | JSON object of custom data |
name | string | Yes | — | Name of page |
notification_email | string | No | — | An email address that will receive transaction notifications for this payment page |
plan | string | No | — | The ID of the plan to subscribe customers on this payment page to when type is set to subscription. |
redirect_url | string | No | — | If you would like Paystack to redirect to a URL upon successful payment, specify the URL here. |
slug | string | No | — | URL slug you would like to be associated with this page. Page will be accessible at https://paystack.com/pay/[slug] |
split_code | string | No | — | The split code of the transaction split. e.g. SPL_98WF13Eb3w |
success_message | string | No | — | A success message to display to the customer after a successful transaction |
type | string | No | — | The type of payment page to create. Defaults to payment if no type is specified. |
paystack_commerce_page_fetch
Fetch Page Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of a payment page |
paystack_commerce_page_list
List Pages Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
perPage | integer | No | — | Number of records to fetch per page |
page | integer | No | — | The section to retrieve |
from | string | No | — | The start date |
to | string | No | — | The end date |
paystack_commerce_page_update
Update Page Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of a payment page |
active | boolean | No | — | Set to false to deactivate page url |
amount | integer | No | — | Amount should be in the subunit of the currency |
description | string | No | — | The description of the page |
name | string | No | — | Name of page |
paystack_commerce_product_create
Create Product Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
currency | string | Yes | — | Currency in which price is set. Allowed values are: NGN, GHS, ZAR or USD |
description | string | Yes | — | The description of the product |
metadata | object | No | — | JSON object of custom data |
name | string | Yes | — | Name of product |
price | integer | Yes | — | Price should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR |
quantity | integer | No | — | Number of products in stock. Use if limited is true |
split_code | string | No | — | The split code if sharing the transaction with partners |
unlimited | boolean | No | — | Set to true if the product has unlimited stock. Leave as false if the product has limited stock |
paystack_commerce_product_delete
Delete Product Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the product |
paystack_commerce_product_fetch
Fetch Product Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the product |
paystack_commerce_product_list
List Products Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
perPage | integer | No | — | Number of records to fetch per page |
page | integer | No | — | The section to retrieve |
active | boolean | No | — | The state of the product |
from | string | No | — | The start date |
to | string | No | — | The end date |
paystack_commerce_product_update
Update product Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the product |
currency | string | No | — | Currency in which price is set. Allowed values are: NGN, GHS, ZAR or USD |
description | string | No | — | The description of the product |
metadata | object | No | — | JSON object of custom data |
name | string | No | — | Name of product |
price | integer | No | — | Price should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR |
quantity | integer | No | — | Number of products in stock. Use if limited is true |
split_code | string | No | — | The split code if sharing the transaction with partners |
unlimited | boolean | No | — | Set to true if the product has unlimited stock. Leave as false if the product has limited stock |
paystack_commerce_storefront_add_products
Add Products to Storefront Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
products | integer[] | Yes | — | An array of product IDs |
paystack_commerce_storefront_create
Create Storefront Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
currency | string | Yes | — | Currency for prices of products in your storefront. |
description | string | No | — | The description of the storefront |
name | string | Yes | — | Name of the storefront |
slug | string | Yes | — | A unique identifier to access your store. Once the storefront is created, it can be accessed from https://paystack.shop/your-slug |
paystack_commerce_storefront_delete
Delete Storefront Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
paystack_commerce_storefront_duplicate
Duplicate Storefront Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
paystack_commerce_storefront_fetch
Fetch Storefront Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
paystack_commerce_storefront_fetch_orders
Fetch Storefront Orders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
paystack_commerce_storefront_list
List Storefronts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
perPage | integer | No | — | Number of records to fetch per request |
page | integer | No | — | The offset to retrieve data from |
status | string | No | — | The status value |
paystack_commerce_storefront_list_products
List Storefront Products Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
paystack_commerce_storefront_publish
Publish Storefront Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
paystack_commerce_storefront_update
Update Storefront Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The unique identifier of the Storefront |
description | string | No | — | The description of the storefront |
name | string | No | — | Name of the storefront |
slug | string | No | — | A unique identifier to access your store. Once the storefront is created, it can be accessed from https://paystack.shop/your-slug |
paystack_commerce_storefront_verify_slug
Verify Storefront Slug Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
slug | string | Yes | — | The custom slug to check |
paystack_commerce_terminal_commission
Commission Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
serial_number | string | Yes | — | Device Serial Number |
paystack_commerce_terminal_decommission
Decommission Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
serial_number | string | Yes | — | Device Serial Number |
paystack_commerce_terminal_fetch
Fetch Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
terminal_id | string | Yes | — | The ID of the Terminal the event should be sent to. |
paystack_commerce_terminal_fetch_event_status
Fetch Event Status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
terminal_id | string | Yes | — | The ID of the Terminal the event should be sent to. |
event_id | string | Yes | — | The ID of the event that was sent to the Terminal |
paystack_commerce_terminal_fetch_terminal_status
Fetch Terminal Status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
terminal_id | string | Yes | — | The ID of the Terminal the event should be sent to. |
paystack_commerce_terminal_list
List Terminals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
next | string | No | — | A cursor that indicates your place in the list. It can be used to fetch the next page of the list |
previous | string | No | — | A cursor that indicates your place in the list. It should be used to fetch the previous page of the list after an intial next request |
per_page | integer | No | — | Specify how many records you want to retrieve per page |
paystack_commerce_terminal_send_event
Send Event Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The ID of the Terminal the event should be sent to. |
action | string | No | — | The action the Terminal needs to perform. For the invoice type, the action can either be process or view. For the transaction type, the action can either be process or print. |
data | object | No | — | The parameters needed to perform the specified action |
type | string | No | — | The type of event to push |
paystack_commerce_terminal_update
Update Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
terminal_id | string | Yes | — | The ID of the Terminal the event should be sent to. |
address | string | No | — | The new address for the Terminal |
name | string | No | — | The new name for the Terminal |
paystack_commerce_virtual_terminal_add_split_code
Add Split Code to Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Code of the Virtual Terminal |
split_code | string | Yes | — | The split code to assign to the virtual terminal |
paystack_commerce_virtual_terminal_create
Create Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
destinations | object[] | Yes | — | Array of objects containing recipients for payment notifications for the Virtual Terminal. |
metadata | object | No | — | Additional custom data as key-value pairs |
name | string | Yes | — | The name of the virtual terminal |
split_code | string | No | — | Split code to associate with the virtual terminal |
paystack_commerce_virtual_terminal_deactivate
Deactivate Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Code of the Virtual Terminal |
paystack_commerce_virtual_terminal_delete_split_code
Remove Split Code from Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Code of the Virtual Terminal |
split_code | string | Yes | — | The split code to assign to the virtual terminal |
paystack_commerce_virtual_terminal_destination_assign
Assign Destination to Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Code of the Virtual Terminal |
destinations | object[] | Yes | — | Array of objects containing recipients for payment notifications for the Virtual Terminal. |
paystack_commerce_virtual_terminal_destination_unassign
Unassign Destination from Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Code of the Virtual Terminal |
targets | string[] | Yes | — | Array of destination targets to unassign |
paystack_commerce_virtual_terminal_fetch
Fetch Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Code of the Virtual Terminal |
paystack_commerce_virtual_terminal_list
List Virtual Terminals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
perPage | integer | No | — | The number of records to fetch per request |
page | integer | No | — | The offset to retrieve data from |
paystack_commerce_virtual_terminal_update
Update Virtual Terminal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Code of the Virtual Terminal |
name | string | Yes | — | Name of the virtual terminal |

