Skip to main content
Server path: /paystack-commerce | Type: Application | PCID required: Yes

Tools

ToolDescription
paystack_commerce_order_createCreate Order
paystack_commerce_order_fetchFetch Order
paystack_commerce_order_listList Orders
paystack_commerce_order_productFetch Product Orders
paystack_commerce_order_validateValidate Order
paystack_commerce_page_add_productsAdd Products
paystack_commerce_page_check_slug_availabilityCheck Slug Availability
paystack_commerce_page_createCreate Page
paystack_commerce_page_fetchFetch Page
paystack_commerce_page_listList Pages
paystack_commerce_page_updateUpdate Page
paystack_commerce_product_createCreate Product
paystack_commerce_product_deleteDelete Product
paystack_commerce_product_fetchFetch Product
paystack_commerce_product_listList Products
paystack_commerce_product_updateUpdate product
paystack_commerce_storefront_add_productsAdd Products to Storefront
paystack_commerce_storefront_createCreate Storefront
paystack_commerce_storefront_deleteDelete Storefront
paystack_commerce_storefront_duplicateDuplicate Storefront
paystack_commerce_storefront_fetchFetch Storefront
paystack_commerce_storefront_fetch_ordersFetch Storefront Orders
paystack_commerce_storefront_listList Storefronts
paystack_commerce_storefront_list_productsList Storefront Products
paystack_commerce_storefront_publishPublish Storefront
paystack_commerce_storefront_updateUpdate Storefront
paystack_commerce_storefront_verify_slugVerify Storefront Slug
paystack_commerce_terminal_commissionCommission Terminal
paystack_commerce_terminal_decommissionDecommission Terminal
paystack_commerce_terminal_fetchFetch Terminal
paystack_commerce_terminal_fetch_event_statusFetch Event Status
paystack_commerce_terminal_fetch_terminal_statusFetch Terminal Status
paystack_commerce_terminal_listList Terminals
paystack_commerce_terminal_send_eventSend Event
paystack_commerce_terminal_updateUpdate Terminal
paystack_commerce_virtual_terminal_add_split_codeAdd Split Code to Virtual Terminal
paystack_commerce_virtual_terminal_createCreate Virtual Terminal
paystack_commerce_virtual_terminal_deactivateDeactivate Virtual Terminal
paystack_commerce_virtual_terminal_delete_split_codeRemove Split Code from Virtual Terminal
paystack_commerce_virtual_terminal_destination_assignAssign Destination to Virtual Terminal
paystack_commerce_virtual_terminal_destination_unassignUnassign Destination from Virtual Terminal
paystack_commerce_virtual_terminal_fetchFetch Virtual Terminal
paystack_commerce_virtual_terminal_listList Virtual Terminals
paystack_commerce_virtual_terminal_updateUpdate Virtual Terminal

paystack_commerce_order_create

Create Order Parameters:
ParameterTypeRequiredDefaultDescription
currencystringYesCurrency in which amount is set
emailstringYesThe email of the customer placing the order
first_namestringYesThe customer’s first name
is_giftbooleanNoA flag to indicate if the order is for someone else
itemsobject[]YesThe items value
last_namestringYesThe customer’s last name
pay_for_mebooleanNoA flag to indicate if the someone else should pay for the order
phonestringYesThe customer’s mobile number
shippingobjectYesThe shipping details of the order

paystack_commerce_order_fetch

Fetch Order Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the order

paystack_commerce_order_list

List Orders Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoNumber of records to fetch per page
pageintegerNoThe section to retrieve
fromstringNoThe start date
tostringNoThe end date

paystack_commerce_order_product

Fetch Product Orders Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the product

paystack_commerce_order_validate

Validate Order Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesThe unique code of a previously created order

paystack_commerce_page_add_products

Add Products Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
productsinteger[]YesA list of IDs of products to add to a page.

paystack_commerce_page_check_slug_availability

Check Slug Availability Parameters:
ParameterTypeRequiredDefaultDescription
slugstringYesThe custom slug to check

paystack_commerce_page_create

Create Page Parameters:
ParameterTypeRequiredDefaultDescription
amountintegerNoAmount should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR
collect_phonebooleanNoSpecify whether to collect phone numbers on the payment page
currencystringNoThe transaction currency. Defaults to your integration currency.
custom_fieldsobject[]NoIf you would like to accept custom fields, specify them here.
descriptionstringNoThe description of the page
fixed_amountbooleanNoSpecifies whether to collect a fixed amount on the payment page. If true, amount must be passed.
metadataobjectNoJSON object of custom data
namestringYesName of page
notification_emailstringNoAn email address that will receive transaction notifications for this payment page
planstringNoThe ID of the plan to subscribe customers on this payment page to when type is set to subscription.
redirect_urlstringNoIf you would like Paystack to redirect to a URL upon successful payment, specify the URL here.
slugstringNoURL slug you would like to be associated with this page. Page will be accessible at https://paystack.com/pay/[slug]
split_codestringNoThe split code of the transaction split. e.g. SPL_98WF13Eb3w
success_messagestringNoA success message to display to the customer after a successful transaction
typestringNoThe type of payment page to create. Defaults to payment if no type is specified.

paystack_commerce_page_fetch

Fetch Page Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of a payment page

paystack_commerce_page_list

List Pages Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoNumber of records to fetch per page
pageintegerNoThe section to retrieve
fromstringNoThe start date
tostringNoThe end date

paystack_commerce_page_update

Update Page Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of a payment page
activebooleanNoSet to false to deactivate page url
amountintegerNoAmount should be in the subunit of the currency
descriptionstringNoThe description of the page
namestringNoName of page

paystack_commerce_product_create

Create Product Parameters:
ParameterTypeRequiredDefaultDescription
currencystringYesCurrency in which price is set. Allowed values are: NGN, GHS, ZAR or USD
descriptionstringYesThe description of the product
metadataobjectNoJSON object of custom data
namestringYesName of product
priceintegerYesPrice should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR
quantityintegerNoNumber of products in stock. Use if limited is true
split_codestringNoThe split code if sharing the transaction with partners
unlimitedbooleanNoSet to true if the product has unlimited stock. Leave as false if the product has limited stock

paystack_commerce_product_delete

Delete Product Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the product

paystack_commerce_product_fetch

Fetch Product Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the product

paystack_commerce_product_list

List Products Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoNumber of records to fetch per page
pageintegerNoThe section to retrieve
activebooleanNoThe state of the product
fromstringNoThe start date
tostringNoThe end date

paystack_commerce_product_update

Update product Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the product
currencystringNoCurrency in which price is set. Allowed values are: NGN, GHS, ZAR or USD
descriptionstringNoThe description of the product
metadataobjectNoJSON object of custom data
namestringNoName of product
priceintegerNoPrice should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR
quantityintegerNoNumber of products in stock. Use if limited is true
split_codestringNoThe split code if sharing the transaction with partners
unlimitedbooleanNoSet 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront
productsinteger[]YesAn array of product IDs

paystack_commerce_storefront_create

Create Storefront Parameters:
ParameterTypeRequiredDefaultDescription
currencystringYesCurrency for prices of products in your storefront.
descriptionstringNoThe description of the storefront
namestringYesName of the storefront
slugstringYesA 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront

paystack_commerce_storefront_duplicate

Duplicate Storefront Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront

paystack_commerce_storefront_fetch

Fetch Storefront Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront

paystack_commerce_storefront_fetch_orders

Fetch Storefront Orders Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront

paystack_commerce_storefront_list

List Storefronts Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoNumber of records to fetch per request
pageintegerNoThe offset to retrieve data from
statusstringNoThe status value

paystack_commerce_storefront_list_products

List Storefront Products Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront

paystack_commerce_storefront_publish

Publish Storefront Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront

paystack_commerce_storefront_update

Update Storefront Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe unique identifier of the Storefront
descriptionstringNoThe description of the storefront
namestringNoName of the storefront
slugstringNoA 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:
ParameterTypeRequiredDefaultDescription
slugstringYesThe custom slug to check

paystack_commerce_terminal_commission

Commission Terminal Parameters:
ParameterTypeRequiredDefaultDescription
serial_numberstringYesDevice Serial Number

paystack_commerce_terminal_decommission

Decommission Terminal Parameters:
ParameterTypeRequiredDefaultDescription
serial_numberstringYesDevice Serial Number

paystack_commerce_terminal_fetch

Fetch Terminal Parameters:
ParameterTypeRequiredDefaultDescription
terminal_idstringYesThe ID of the Terminal the event should be sent to.

paystack_commerce_terminal_fetch_event_status

Fetch Event Status Parameters:
ParameterTypeRequiredDefaultDescription
terminal_idstringYesThe ID of the Terminal the event should be sent to.
event_idstringYesThe ID of the event that was sent to the Terminal

paystack_commerce_terminal_fetch_terminal_status

Fetch Terminal Status Parameters:
ParameterTypeRequiredDefaultDescription
terminal_idstringYesThe ID of the Terminal the event should be sent to.

paystack_commerce_terminal_list

List Terminals Parameters:
ParameterTypeRequiredDefaultDescription
nextstringNoA cursor that indicates your place in the list. It can be used to fetch the next page of the list
previousstringNoA 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_pageintegerNoSpecify how many records you want to retrieve per page

paystack_commerce_terminal_send_event

Send Event Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID of the Terminal the event should be sent to.
actionstringNoThe 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.
dataobjectNoThe parameters needed to perform the specified action
typestringNoThe type of event to push

paystack_commerce_terminal_update

Update Terminal Parameters:
ParameterTypeRequiredDefaultDescription
terminal_idstringYesThe ID of the Terminal the event should be sent to.
addressstringNoThe new address for the Terminal
namestringNoThe new name for the Terminal

paystack_commerce_virtual_terminal_add_split_code

Add Split Code to Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesCode of the Virtual Terminal
split_codestringYesThe split code to assign to the virtual terminal

paystack_commerce_virtual_terminal_create

Create Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
destinationsobject[]YesArray of objects containing recipients for payment notifications for the Virtual Terminal.
metadataobjectNoAdditional custom data as key-value pairs
namestringYesThe name of the virtual terminal
split_codestringNoSplit code to associate with the virtual terminal

paystack_commerce_virtual_terminal_deactivate

Deactivate Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesCode of the Virtual Terminal

paystack_commerce_virtual_terminal_delete_split_code

Remove Split Code from Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesCode of the Virtual Terminal
split_codestringYesThe split code to assign to the virtual terminal

paystack_commerce_virtual_terminal_destination_assign

Assign Destination to Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesCode of the Virtual Terminal
destinationsobject[]YesArray of objects containing recipients for payment notifications for the Virtual Terminal.

paystack_commerce_virtual_terminal_destination_unassign

Unassign Destination from Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesCode of the Virtual Terminal
targetsstring[]YesArray of destination targets to unassign

paystack_commerce_virtual_terminal_fetch

Fetch Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesCode of the Virtual Terminal

paystack_commerce_virtual_terminal_list

List Virtual Terminals Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoThe number of records to fetch per request
pageintegerNoThe offset to retrieve data from

paystack_commerce_virtual_terminal_update

Update Virtual Terminal Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesCode of the Virtual Terminal
namestringYesName of the virtual terminal