Requirements
Connecting Paystack takes an active account plus an API access token from your account settings — no other setup is required.[3]
Get your Paystack credentials
- Secret KeypasswordRequired
Your secret API key (Settings → API Keys & Webhooks in the dashboard). Use a test secret key while building, and swap in a live secret key when you go live.
[1]
Connect Paystack in WEXTL
- Log in to your WEXTL account, add the Paystack node module to your workflow, and click Create new credential.Instant triggers use webhooks — click Create a webhook first when adding one, then create the credential.
- Optional: In the Credential name field, enter a name for the credential.
- Enter the authentication credentials you copied from your Paystack account, or follow the on-screen instructions to create the credential.
- If prompted, authenticate your account and confirm access.
- If you want to make changes to your credential in the future, follow the steps in Manage credentials →
Notes
Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →
Paystack node modules
The list below is a reference of every Paystack node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.
Expand any Paystack node module below to see exactly what it takes in, what it returns, and what connection it needs.
Watch New CustomersTrigger
| Field | Type |
|---|---|
| ID | number |
| First Name | text |
| Last Name | text |
| Customer Code | text |
| Phone | text |
| Metadata | text |
| Risk Action | text |
| Domain | text |
Watch New DisputesTrigger
| Field | Type |
|---|---|
| ID | number |
| Refund Amount | number |
| Currency | text |
| Status | text |
| Resolution | text |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Category | text |
| Customer | object |
| ID | number |
| Customer Code | text |
| Due At | date |
Watch New PlansTrigger
| Field | Type |
|---|---|
| ID | number |
| Name | text |
| Plan Code | text |
| Description | text |
| Amount | number |
| Interval | text |
| Invoice Limit | number |
| Send Invoices | boolean |
| Send SMS | boolean |
Watch New RefundsTrigger
| Field | Type |
|---|---|
| ID | number |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Amount | number |
| Deducted Amount | number |
| Currency | text |
| Channel | text |
| Fully Deducted | boolean |
| Refunded By | text |
| Refunded At | date |
Watch New TransactionsTrigger
| Field | Type |
|---|---|
| ID | number |
| Domain | text |
| Status | text |
| Reference | text |
| Amount | number |
| Message | text |
| Gateway Response | text |
| Paid At | date |
| Created At | date |
Watch New TransfersTrigger
| Field | Type |
|---|---|
| ID | number |
| Domain | text |
| Amount | number |
| Currency | text |
| Source | text |
| Reason | text |
| Recipient | object |
| ID | number |
| Type | text |
| Name | text |
| Recipient Code | text |
| Status | text |
| Transfer Code | text |
Watch Webhook EventTrigger
| Field | Type |
|---|---|
| Event | text |
| Data | object |
| ID | number |
| Domain | text |
| Status | text |
| Reference | text |
| Amount | number |
| Message | text |
| Gateway Response | text |
| Paid At | date |
| Created At | date |
| Channel | text |
Balance LedgerSearch
Check Pending ChargeSearch
Check Slug AvailabilitySearch
Export DisputesSearch
Export TransactionsSearch
Export TransfersSearch
Fetch BalanceSearch
Fetch Bank ProvidersSearch
Fetch BanksSearch
| Field | Type |
|---|---|
| Country | text |
| Use Cursor | boolean |
| Next Cursor | text |
| Previous Cursor | text |
| Pay With Bank Transfer | boolean |
| Pay With Bank | boolean |
| Enabled For Verification | boolean |
| Gateway | text |
| Type | text |
| Field | Type |
|---|---|
| ID | number |
| Name | text |
| Slug | text |
| Code | text |
| Longcode | text |
| Gateway | text |
| Pay With Bank | boolean |
| Active | boolean |
| Country | text |
Fetch Bulk Charge BatchSearch
Fetch Charges in a BatchSearch
| Field | Type |
|---|---|
Batch CodeRequired | text |
| Status | text |
| Limit | number |
| Field | Type |
|---|---|
| Integration | number |
| Bulk Charge | number |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
| Authorization | object |
| Authorization Code | text |
| Bin | text |
| Last 4 | text |
| Channel | text |
| Card Type | text |
| Bank | text |
| Transaction | object |
| ID | number |
| Reference | text |
| Status | text |
| Amount | number |
| Currency | text |
| Domain | text |
| Amount | number |
| Currency | text |
| Status | text |
Fetch CustomerSearch
Fetch Dedicated AccountSearch
| Field | Type |
|---|---|
Account IDRequired | number |
| Field | Type |
|---|---|
| ID | number |
| Account Number | text |
| Account Name | text |
| Currency | text |
| Bank | object |
| Name | text |
| ID | number |
| Slug | text |
| Assigned | boolean |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
| Split Config | object |
| Subaccount | text |
| Active | boolean |
Fetch DisputeSearch
| Field | Type |
|---|---|
IDRequired | text |
| Field | Type |
|---|---|
| ID | number |
| Refund Amount | number |
| Currency | text |
| Status | text |
| Resolution | text |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Transaction Reference | text |
| Category | text |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
Fetch PageSearch
Fetch Payment RequestSearch
Fetch Payment Session TimeoutSearch
| Field | Type |
|---|---|
| Payment Session Timeout | number |
Fetch PlanSearch
Fetch ProductSearch
Fetch RefundSearch
Fetch SettlementsSearch
Fetch SplitSearch
Fetch SubaccountSearch
Fetch SubscriptionSearch
Fetch TransactionSearch
Fetch Transaction TimelineSearch
Fetch TransferSearch
Fetch Transfer RecipientSearch
Get Dispute Upload URLSearch
Get Transaction EventSearch
Get Transaction SessionSearch
List Bulk Charge BatchesSearch
List CountriesSearch
List CustomersSearch
List Dedicated AccountsSearch
| Field | Type |
|---|---|
| Account Number | text |
| Active | boolean |
| Currency | text |
| Provider Slug | text |
| Bank ID | text |
| Customer | text |
| Limit | number |
| Field | Type |
|---|---|
| ID | number |
| Account Number | text |
| Account Name | text |
| Currency | text |
| Bank | object |
| Name | text |
| ID | number |
| Slug | text |
| Assigned | boolean |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
| Split Config | object |
| Subaccount | text |
| Active | boolean |
List DisputesSearch
| Field | Type |
|---|---|
| From | date |
| To | date |
| Status | choice |
| Transaction | text |
| Limit | number |
| Field | Type |
|---|---|
| ID | number |
| Refund Amount | number |
| Currency | text |
| Status | text |
| Resolution | text |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Transaction Reference | text |
| Category | text |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
List PagesSearch
List Payment RequestsSearch
List PlansSearch
List ProductsSearch
List RefundsSearch
List SplitsSearch
List States (AVS)Search
List SubaccountsSearch
List SubscriptionsSearch
List Transaction DisputesSearch
| Field | Type |
|---|---|
IDRequired | text |
| Limit | number |
| Field | Type |
|---|---|
| ID | number |
| Refund Amount | number |
| Currency | text |
| Status | text |
| Resolution | text |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Transaction Reference | text |
| Category | text |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
List TransactionsSearch
List Transfer RecipientsSearch
List TransfersSearch
Payment Request TotalsSearch
| Field | Type |
|---|---|
| Pending | array |
| Successful | array |
| Total | array |
Resolve Account NumberSearch
Resolve BVNSearch
Resolve Card BINSearch
Settlement TransactionsSearch
Transaction TotalsSearch
Verify Payment RequestSearch
Verify TransactionSearch
Verify TransferSearch
Add Dispute EvidenceAction
| Field | Type |
|---|---|
IDRequired | text |
Customer EmailRequired | text |
Customer NameRequired | text |
Customer PhoneRequired | text |
Service DetailsRequired | text |
| Delivery Address | text |
| Delivery Date | date |
| Field | Type |
|---|---|
| Customer Email | text |
| Customer Name | text |
| Customer Phone | text |
| Service Details | text |
| Delivery Address | text |
| Delivery Date | date |
| Dispute ID | number |
| Created At | date |
| Updated At | date |
Add Products to PageAction
Add Subaccount to SplitAction
Archive Payment RequestAction
Bulk Create Transfer RecipientAction
BVN MatchAction
Charge AuthorizationAction
| Field | Type |
|---|---|
EmailRequired | text |
AmountRequired | number |
Authorization CodeRequired | text |
| Reference | text |
| Currency | choice |
| Metadata | text |
| Split Code | choice |
| Subaccount | choice |
| Transaction Charge | number |
| Field | Type |
|---|---|
| ID | number |
| Domain | text |
| Status | text |
| Reference | text |
| Amount | number |
| Message | text |
| Gateway Response | text |
| Paid At | date |
| Created At | date |
Check AuthorizationAction
Create ChargeAction
| Field | Type |
|---|---|
EmailRequired | |
AmountRequired | number |
| Bank | object |
| Bank Code | text |
| Account Number | text |
| Authorization Code | text |
| USSD | object |
| USSD Type | choice |
| Mobile Money | object |
| Phone | text |
| Provider | text |
| EFT | object |
| Provider | choice |
| PIN | text |
| Metadata | text |
| Field | Type |
|---|---|
| Reference | text |
| Status | text |
| Display Text | text |
| ID | number |
| Amount | number |
| Currency | text |
| Transaction Date | date |
| Domain | text |
| Gateway Response | text |
Create CustomerAction
Create Dedicated AccountAction
| Field | Type |
|---|---|
CustomerRequired | choice |
| Preferred Bank | text |
| Subaccount | choice |
| Split Code | choice |
| Field | Type |
|---|---|
| ID | number |
| Account Number | text |
| Account Name | text |
| Currency | text |
| Bank | object |
| Name | text |
| ID | number |
| Slug | text |
| Assigned | boolean |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
| Split Config | object |
| Subaccount | text |
| Active | boolean |
Create PageAction
Create Payment RequestAction
| Field | Type |
|---|---|
CustomerRequired | choice |
| Amount | number |
| Currency | text |
| Due Date | date |
| Description | text |
| Line Items | array |
| Tax | array |
| Send Notification | boolean |
| Draft | boolean |
| Field | Type |
|---|---|
| ID | number |
| Domain | text |
| Invoice Number | number |
| Amount | number |
| Discount | number |
| Currency | text |
| Due Date | date |
| Has Invoice | boolean |
| Description | text |
Create PlanAction
| Field | Type |
|---|---|
NameRequired | text |
AmountRequired | number |
IntervalRequired | choice |
| Description | text |
| Send Invoices | boolean |
| Send SMS | boolean |
| Currency | choice |
| Invoice Limit | number |
| Field | Type |
|---|---|
| ID | number |
| Name | text |
| Plan Code | text |
| Description | text |
| Amount | number |
| Interval | text |
| Invoice Limit | number |
| Send Invoices | boolean |
| Send SMS | boolean |
Create ProductAction
Create RefundAction
| Field | Type |
|---|---|
TransactionRequired | text |
| Amount | number |
| Currency | choice |
| Customer Note | text |
| Merchant Note | text |
| Field | Type |
|---|---|
| ID | number |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Dispute | text |
| Settlement | text |
| Amount | number |
| Deducted Amount | number |
| Currency | text |
| Channel | text |
| Fully Deducted | boolean |
Create SplitAction
Create SubaccountAction
| Field | Type |
|---|---|
Business NameRequired | text |
Settlement BankRequired | choice |
Account NumberRequired | text |
Percentage ChargeRequired | number |
| Description | text |
| Primary Contact Email | text |
| Primary Contact Name | text |
| Primary Contact Phone | text |
| Metadata | text |
| Field | Type |
|---|---|
| ID | number |
| Subaccount Code | text |
| Business Name | text |
| Description | text |
| Primary Contact Name | text |
| Primary Contact Email | text |
| Primary Contact Phone | text |
| Metadata | text |
| Percentage Charge | number |
Create SubscriptionAction
Create Transfer RecipientAction
| Field | Type |
|---|---|
TypeRequired | choice |
NameRequired | text |
Account NumberRequired | text |
Bank CodeRequired | choice |
| Description | text |
| Currency | choice |
| Authorization Code | text |
| Metadata | text |
| Field | Type |
|---|---|
| ID | number |
| Active | boolean |
| Currency | text |
| Description | text |
| Domain | text |
| Metadata | text |
| Name | text |
| Recipient Code | text |
| Type | text |
Deactivate AuthorizationAction
Deactivate Dedicated AccountAction
Delete Transfer RecipientAction
Disable OTP Requirement for TransfersAction
| Field | Type |
|---|---|
| Status | boolean |
| Message | text |
Disable SubscriptionAction
Enable OTP Requirement for TransfersAction
| Field | Type |
|---|---|
| Status | boolean |
| Message | text |
Enable SubscriptionAction
Finalize Disable OTPAction
Finalize Payment RequestAction
Finalize TransferAction
Generate Update Subscription LinkAction
Initialize TransactionAction
Initiate Bulk ChargeAction
Initiate Bulk TransferAction
Initiate TransferAction
| Field | Type |
|---|---|
SourceRequired | choice |
AmountRequired | number |
RecipientRequired | choice |
| Reason | text |
| Currency | choice |
| Reference | text |
| Field | Type |
|---|---|
| ID | number |
| Domain | text |
| Amount | number |
| Currency | text |
| Source | text |
| Source Details | text |
| Reason | text |
| Recipient | object |
| ID | number |
| Type | text |
| Name | text |
| Recipient Code | text |
| Details | object |
| Status | text |
Make an API Calluniversal
Partial DebitAction
Pause Bulk Charge BatchAction
Remove Subaccount from SplitAction
Resend OTP for TransferAction
Resolve DisputeAction
| Field | Type |
|---|---|
IDRequired | text |
ResolutionRequired | choice |
MessageRequired | text |
Refund AmountRequired | number |
Uploaded FilenameRequired | text |
| Evidence | number |
| Field | Type |
|---|---|
| ID | number |
| Refund Amount | number |
| Currency | text |
| Status | text |
| Resolution | text |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Transaction Reference | text |
| Category | text |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
Resume Bulk Charge BatchAction
Send Payment Request NotificationAction
Send Update Subscription EmailAction
Split Dedicated Account TransactionAction
Submit AddressAction
Submit BirthdayAction
Submit OTPAction
Submit PhoneAction
Submit PINAction
Update CustomerAction
Update DisputeAction
| Field | Type |
|---|---|
IDRequired | text |
Refund AmountRequired | number |
| Uploaded Filename | text |
| Field | Type |
|---|---|
| ID | number |
| Refund Amount | number |
| Currency | text |
| Status | text |
| Resolution | text |
| Transaction | object |
| ID | number |
| Reference | text |
| Amount | number |
| Currency | text |
| Transaction Reference | text |
| Category | text |
| Customer | object |
| ID | number |
| First Name | text |
| Last Name | text |
| text | |
| Customer Code | text |
Update PageAction
Update Payment RequestAction
| Field | Type |
|---|---|
IDRequired | number |
| Customer | choice |
| Amount | number |
| Currency | text |
| Due Date | date |
| Description | text |
| Line Items | array |
| Tax | array |
| Send Notification | boolean |
| Field | Type |
|---|---|
| ID | number |
| Domain | text |
| Invoice Number | number |
| Amount | number |
| Discount | number |
| Currency | text |
| Due Date | date |
| Has Invoice | boolean |
| Description | text |
Update Payment Session TimeoutAction
Update PlanAction
| Field | Type |
|---|---|
CodeRequired | text |
| Name | text |
| Amount | number |
| Interval | choice |
| Description | text |
| Send Invoices | boolean |
| Send SMS | boolean |
| Currency | choice |
| Invoice Limit | number |
| Field | Type |
|---|---|
| ID | number |
| Name | text |
| Plan Code | text |
| Description | text |
| Amount | number |
| Interval | text |
| Invoice Limit | number |
| Send Invoices | boolean |
| Send SMS | boolean |
Update ProductAction
Update SplitAction
Update SubaccountAction
| Field | Type |
|---|---|
CodeRequired | choice |
| Business Name | text |
| Settlement Bank | choice |
| Account Number | text |
| Active | boolean |
| Percentage Charge | number |
| Description | text |
| Primary Contact Email | text |
| Primary Contact Name | text |
| Field | Type |
|---|---|
| ID | number |
| Subaccount Code | text |
| Business Name | text |
| Description | text |
| Primary Contact Name | text |
| Primary Contact Email | text |
| Primary Contact Phone | text |
| Metadata | text |
| Percentage Charge | number |
Update Transfer RecipientAction
Validate CustomerAction
Templates
Look for Paystack templates in the WEXTL template library.
Browse templates →Explore alternative apps
- Chargebee[2]Subscription billing for customers, plans, invoices, and payments.
- AdyenGlobal payment platform for online, in-person, and unified commerce transactions.
- BillingoHungarian online invoicing and billing platform for creating invoices, tracking payments, and managing customers.
- BillogramDigital invoicing and billing platform that sends invoices and collects payments from customers.
- CoinbaseCryptocurrency exchange and payments platform for trading, transfers, and digital asset orders.
References
- WEXTL® Paystack Source Code connector implementation.
- Our users use cases and automations.
- Official API Documentation for Paystack.
- WEXTL® visual workflow builder data.
Last updated: Sep 5, 2026 10:04