/paystack-customers | Type: Application | PCID required: Yes
Tools
paystack_customers_customer_create
Create Customer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
email | string | Yes | — | Customer’s email address |
first_name | string | No | — | Customer’s first name |
last_name | string | No | — | Customer’s last name |
metadata | string | No | — | Stringified JSON object of custom data |
phone | string | No | — | Customer’s phone number |
paystack_customers_customer_deactivate_authorization
Deactivate Authorization Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
authorization_code | string | Yes | — | Authorization code to be deactivated |
paystack_customers_customer_direct_debit_activation_charge
Direct Debit Activation Charge Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The customer ID attached to the authorization |
authorization_id | integer | Yes | — | The authorization ID gotten from the initiation response |
paystack_customers_customer_fetch
Fetch Customer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The code for the customer gotten from the response of the customer creation |
paystack_customers_customer_fetch_mandate_authorizations
Fetch Mandate Authorizations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The customer ID for the authorizations to fetch |
paystack_customers_customer_initialize_authorization
Initialize Authorization Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
account | object | No | — | The account value |
address | object | No | — | The address value |
callback_url | string | No | — | Fully qualified url (e.g. https://example.com/) to redirect your customer to |
channel | string | Yes | — | direct_debit is the only supported option for now |
email | string | Yes | — | Customer’s email address |
paystack_customers_customer_initialize_direct_debit
Initialize Direct Debit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the customer to initialize the direct debit for |
account | object | Yes | — | The account value |
address | object | Yes | — | The address value |
paystack_customers_customer_list
List Customers Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
use_cursor | boolean | No | — | A flag to indicate if cursor based pagination should be used |
next | string | No | — | An alphanumeric value returned for every cursor based retrieval, used to retrieve the next set of data |
previous | string | No | — | An alphanumeric value returned for every cursor based retrieval, used to retrieve the previous set of data |
from | string | No | — | The start date |
to | string | No | — | The end date |
perPage | integer | No | — | The number of records to fetch per request |
page | integer | No | — | The offset to retrieve data from |
paystack_customers_customer_risk_action
Set Risk Action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customer | string | Yes | — | The customer code from the response of the customer creation |
risk_action | string | No | — | This determines the fraud rules that should be applied to the customer |
paystack_customers_customer_update
Update Customer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The code for the customer gotten from the response of the customer creation |
first_name | string | No | — | Customer’s first name |
last_name | string | No | — | Customer’s last name |
metadata | string | No | — | Stringified JSON object of custom data |
phone | string | No | — | Customer’s phone number |
paystack_customers_customer_validate
Validate Customer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The code for the customer gotten from the response of the customer creation |
account_number | string | Yes | — | Customer’s bank account number. |
bank_code | string | Yes | — | You can get the list of bank codes by calling the List Banks endpoint (https://api.paystack.co/bank). |
bvn | string | Yes | — | Customer’s Bank Verification Number |
country | string | Yes | — | Two-letter country code of identification issuer |
first_name | string | Yes | — | Customer’s first name |
last_name | string | Yes | — | Customer’s last name |
middle_name | string | No | — | Customer’s middle name |
type | string | Yes | — | Predefined types of identification. |
value | string | No | — | Customer’s identification number. |
paystack_customers_customer_verify_authorization
Verify Authorization Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
reference | string | Yes | — | The reference returned in the initialization response |
paystack_customers_dedicated_account_add_split
Split Dedicated Account Transaction Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
account_number | string | Yes | — | Valid Dedicated virtual account |
split_code | string | No | — | Split code consisting of the lists of accounts you want to split the transaction with |
subaccount | string | No | — | Subaccount code of the account you want to split the transaction with |
paystack_customers_dedicated_account_assign
Assign Dedicated Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
account_number | string | No | — | Customer’s account number |
bank_code | string | No | — | Customer’s bank code |
bvn | string | No | — | Customer’s Bank Verification Number |
country | string | Yes | — | The two letter code country |
email | string | Yes | — | Customer’s email address |
first_name | string | Yes | — | Customer’s first name |
last_name | string | Yes | — | Customer’s last name |
phone | string | Yes | — | Customer’s phone name |
preferred_bank | string | Yes | — | The bank slug for preferred bank. To get a list of available banks, use the List Banks endpoint, passing pay_with_bank_transfer=true query parameter |
split_code | string | No | — | Split code consisting of the lists of accounts you want to split the transaction with |
subaccount | string | No | — | Subaccount code of the account you want to split the transaction with |
paystack_customers_dedicated_account_available_providers
Fetch Bank Providerspaystack_customers_dedicated_account_create
Create Dedicated Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customer | string | Yes | — | The code for the previously created customer |
preferred_bank | string | No | — | The bank slug for preferred bank. To get a list of available banks, use the List Providers endpoint |
split_code | string | No | — | Split code consisting of the lists of accounts you want to split the transaction with |
subaccount | string | No | — | Subaccount code of the account you want to split the transaction with |
paystack_customers_dedicated_account_deactivate
Deactivate Dedicated Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | ID of dedicated virtual account |
paystack_customers_dedicated_account_fetch
Fetch Dedicated Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | ID of dedicated virtual account |
paystack_customers_dedicated_account_list
List Dedicated Accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
active | boolean | No | — | Status of the dedicated virtual account |
customer | integer | No | — | The customer’s ID |
currency | string | No | — | The currency of the dedicated virtual account |
provider_slug | string | No | — | The bank’s slug in lowercase, without spaces |
bank_id | string | No | — | The bank’s ID |
perPage | integer | No | — | The number of records to fetch per request |
page | integer | No | — | The offset to retrieve data from |
paystack_customers_dedicated_account_remove_split
Remove Split from Dedicated Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
account_number | string | Yes | — | Valid Dedicated virtual account |
paystack_customers_dedicated_account_requery
Requery Dedicated Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
account_number | string | No | — | Virtual account number to requery |
provider_slug | string | No | — | The bank’s slug in lowercase, without spaces. |
date | string | No | — | The day the transfer was made |
paystack_customers_directdebit_list_mandate_authorizations
List Mandate Authorizations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | The cursor value of the next set of authorizations to fetch. You can get this from the meta object of the response |
status | string | No | — | Filter by the authorization status |
per_page | integer | No | — | The number of authorizations to fetch per request |
paystack_customers_directdebit_trigger_activation_charge
Trigger Activation Charge Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customer_ids | integer[] | Yes | — | Array of customer IDs to trigger activation charge for |
paystack_customers_plan_create
Create Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
amount | integer | Yes | — | Amount should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR |
currency | string | No | — | Currency in which amount is set. Allowed values are NGN, GHS, ZAR or USD |
description | string | No | — | A description for this plan |
interval | string | Yes | — | Payment interval |
invoice_limit | integer | No | — | Number of invoices to raise during subscription to this plan. Can be overridden by specifying an invoice_limit while subscribing. |
name | string | Yes | — | Name of plan |
send_invoices | boolean | No | — | Set to false if you don’t want invoices to be sent to your customers |
send_sms | boolean | No | — | Set to false if you don’t want text messages to be sent to your customers |
paystack_customers_plan_fetch
Fetch Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The plan code you want to fetch |
paystack_customers_plan_list
List Plans Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
perPage | integer | No | — | Number of records to fetch per page |
page | integer | No | — | The section to retrieve |
interval | string | No | — | Specify interval of the plan |
amount | integer | No | — | The amount on the plans to retrieve |
from | string | No | — | The start date |
to | string | No | — | The end date |
paystack_customers_plan_update
Update Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The plan code you want to fetch |
amount | integer | No | — | Amount should be in kobo if currency is NGN, pesewas, if currency is GHS, and cents, if currency is ZAR |
currency | string | No | — | Currency in which amount is set. Allowed values are NGN, GHS, ZAR or USD |
description | string | No | — | A description for this plan |
interval | string | No | — | Payment interval |
invoice_limit | integer | No | — | Number of invoices to raise during subscription to this plan. Can be overridden by specifying an invoice_limit while subscribing. |
name | string | No | — | Name of plan |
send_invoices | boolean | No | — | Set to false if you don’t want invoices to be sent to your customers |
send_sms | boolean | No | — | Set to false if you don’t want text messages to be sent to your customers |
paystack_customers_subaccount_create
Create Subaccount Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
account_number | string | Yes | — | Bank account number |
business_name | string | Yes | — | Name of business for subaccount |
description | string | No | — | A description for this subaccount |
metadata | string | No | — | Stringified JSON object of custom data |
percentage_charge | number | Yes | — | The percentage charge on transactions for this subaccount |
primary_contact_email | string | No | — | A contact email for the subaccount |
primary_contact_name | string | No | — | The name of the contact person for this subaccount |
primary_contact_phone | string | No | — | A phone number to call for this subaccount |
settlement_bank | string | Yes | — | Bank code for the bank. You can get the list of Bank Codes by calling the List Banks endpoint. |
paystack_customers_subaccount_fetch
Fetch Subaccount Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The subaccount code you want to fetch |
paystack_customers_subaccount_list
List Subaccounts 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 |
active | boolean | No | — | Filter by the state of the subaccounts |
paystack_customers_subaccount_update
Update Subaccount Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The subaccount code you want to fetch |
account_number | string | No | — | Bank account number |
active | boolean | No | — | Activate or deactivate a subaccount |
business_name | string | No | — | Name of business for subaccount |
description | string | No | — | A description for this subaccount |
metadata | string | No | — | Stringified JSON object of custom data |
percentage_charge | number | No | — | Customer’s phone number |
primary_contact_email | string | No | — | A contact email for the subaccount |
primary_contact_name | string | No | — | The name of the contact person for this subaccount |
primary_contact_phone | string | No | — | A phone number to call for this subaccount |
settlement_bank | string | No | — | Bank code for the bank. You can get the list of Bank Codes by calling the List Banks endpoint. |
paystack_customers_subscription_create
Create Subscription Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
authorization | string | No | — | If customer has multiple authorizations, you can set the desired authorization you wish to use for this subscription here. If this is not supplied, the customer’s most recent authorization would be used |
customer | string | Yes | — | Customer’s email address or customer code |
plan | string | Yes | — | Plan code |
start_date | string | No | — | Set the date for the first debit. (ISO 8601 format) e.g. 2017-05-16T00:30:13+01:00 |
paystack_customers_subscription_disable
Disable Subscription Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Subscription code |
token | string | Yes | — | Email token |
paystack_customers_subscription_enable
Enable Subscription Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Subscription code |
token | string | Yes | — | Email token |
paystack_customers_subscription_fetch
Fetch Subscription Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | The subscription code for the subscription you want to fetch |
paystack_customers_subscription_list
List Subscriptions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
perPage | integer | No | — | Number of records to fetch per page |
page | integer | No | — | The section to retrieve |
plan | integer | No | — | Plan ID |
customer | string | No | — | Customer ID |
from | string | No | — | The start date |
to | string | No | — | The end date |
paystack_customers_subscription_manage_email
Send Update Subscription Link Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Subscription code |
paystack_customers_subscription_manage_link
Generate Update Subscription Link Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | — | Subscription code |

