# Paystack API

> Paystack API on Apizie: 120 endpoints (Initialize Transaction, Verify Transaction, List Transactions, Fetch Transaction, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/payments:paystack/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `payments:paystack`
- Category: Payments
- Status: byok
- Source: https://paystack.com/docs/api/
- Page: https://www.apizie.tech/api/payments/paystack
- OpenAPI: https://www.apizie.tech/api/payments/paystack/openapi.json

The OpenAPI specification of the Paystack API that merchants and developers can harness to build financial solutions in Africa.

## Endpoints

### Initialize Transaction
`POST https://www.apizie.tech/v1/payments:paystack/transaction-initialize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Verify Transaction
`GET https://www.apizie.tech/v1/payments:paystack/transaction-verify` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reference | string | yes | The transaction reference to verify |

### List Transactions
`GET https://www.apizie.tech/v1/payments:paystack/transaction-list` (byok)

| Parameter | Type | Required | 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 |

### Fetch Transaction
`GET https://www.apizie.tech/v1/payments:paystack/transaction-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the transaction to fetch |

### Fetch Transaction Timeline
`GET https://www.apizie.tech/v1/payments:paystack/transaction-timeline` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id_or_reference | string | yes |  |

### Transaction Totals
`GET https://www.apizie.tech/v1/payments:paystack/transaction-totals` (byok)

| Parameter | Type | Required | 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 |

### Export Transactions
`GET https://www.apizie.tech/v1/payments:paystack/transaction-download` (byok)

| Parameter | Type | Required | 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 |

### Charge Authorization
`POST https://www.apizie.tech/v1/payments:paystack/transaction-charge-authorization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Check Authorization
`POST https://www.apizie.tech/v1/payments:paystack/transaction-check-authorization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Partial Debit
`POST https://www.apizie.tech/v1/payments:paystack/transaction-partial-debit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Get Transaction Event
`GET https://www.apizie.tech/v1/payments:paystack/transaction-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Get Transaction Session
`GET https://www.apizie.tech/v1/payments:paystack/transaction-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List Splits
`GET https://www.apizie.tech/v1/payments:paystack/split-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | no |  |
| active | string | no |  |
| sort_by | string | no |  |
| from | string | no |  |
| to | string | no |  |
| perPage | string | no |  |
| page | string | no |  |

### Create Split
`POST https://www.apizie.tech/v1/payments:paystack/split-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Split
`GET https://www.apizie.tech/v1/payments:paystack/split-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Split
`POST https://www.apizie.tech/v1/payments:paystack/split-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Add Subaccount to Split
`POST https://www.apizie.tech/v1/payments:paystack/split-add-subaccount` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Remove Subaccount from split
`POST https://www.apizie.tech/v1/payments:paystack/split-remove-subaccount` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### List Customers
`GET https://www.apizie.tech/v1/payments:paystack/customer-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| use_cursor | boolean | no |  |
| next | string | no |  |
| previous | string | no |  |
| from | string | no |  |
| to | string | no |  |
| perPage | string | no |  |
| page | string | no |  |

### Create Customer
`POST https://www.apizie.tech/v1/payments:paystack/customer-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Customer
`GET https://www.apizie.tech/v1/payments:paystack/customer-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |

### Update Customer
`POST https://www.apizie.tech/v1/payments:paystack/customer-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |
| body | object | no | Form fields as a JSON object |

### White/blacklist Customer
`POST https://www.apizie.tech/v1/payments:paystack/customer-risk-action` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Deactivate Authorization
`POST https://www.apizie.tech/v1/payments:paystack/customer-deactivate-authorization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Validate Customer
`POST https://www.apizie.tech/v1/payments:paystack/customer-validatte` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Path parameter {code} |
| body | object | no | Form fields as a JSON object |

### List Dedicated Accounts
`GET https://www.apizie.tech/v1/payments:paystack/dedicated-account-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_number | string | no |  |
| customer | string | no |  |
| active | boolean | no |  |
| currency | string | no |  |
| provider_slug | string | no |  |
| bank_id | string | no |  |
| perPage | string | no |  |
| page | string | no |  |

### Create Dedicated Account
`POST https://www.apizie.tech/v1/payments:paystack/dedicated-account-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Dedicated Account
`GET https://www.apizie.tech/v1/payments:paystack/dedicated-account-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string | yes |  |

### Deactivate Dedicated Account
`POST https://www.apizie.tech/v1/payments:paystack/dedicated-account-deactivate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string | yes |  |

### Fetch Bank Providers
`GET https://www.apizie.tech/v1/payments:paystack/dedicated-account-available-providers` (byok)

### Split Dedicated Account Transaction
`POST https://www.apizie.tech/v1/payments:paystack/dedicated-account-add-split` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### List Subaccounts
`GET https://www.apizie.tech/v1/payments:paystack/subaccount-list` (byok)

| Parameter | Type | Required | 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 |

### Create Subaccount
`POST https://www.apizie.tech/v1/payments:paystack/subaccount-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Subaccount
`GET https://www.apizie.tech/v1/payments:paystack/subaccount-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |

### Update Subaccount
`POST https://www.apizie.tech/v1/payments:paystack/subaccount-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |
| body | object | no | Form fields as a JSON object |

### List Plans
`GET https://www.apizie.tech/v1/payments:paystack/plan-list` (byok)

| Parameter | Type | Required | 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 |

### Create Plan
`POST https://www.apizie.tech/v1/payments:paystack/plan-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Plan
`GET https://www.apizie.tech/v1/payments:paystack/plan-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |

### Update Plan
`POST https://www.apizie.tech/v1/payments:paystack/plan-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |
| body | object | no | Form fields as a JSON object |

### List Subscriptions
`GET https://www.apizie.tech/v1/payments:paystack/subscription-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no | Number of records to fetch per page |
| page | integer | no | The section to retrieve |
| plan | string | no | Plan ID |
| customer | string | no | Customer ID |
| from | string | no | The start date |
| to | string | no | The end date |

### Create Subscription
`POST https://www.apizie.tech/v1/payments:paystack/subscription-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Subscription
`GET https://www.apizie.tech/v1/payments:paystack/subscription-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |

### Disable Subscription
`POST https://www.apizie.tech/v1/payments:paystack/subscription-disable` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Enable Subscription
`POST https://www.apizie.tech/v1/payments:paystack/subscription-enable` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Generate Update Subscription Link
`POST https://www.apizie.tech/v1/payments:paystack/subscription-manage-link` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |

### Send Update Subscription Link
`POST https://www.apizie.tech/v1/payments:paystack/subscription-manage-email` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes |  |

### List Products
`GET https://www.apizie.tech/v1/payments:paystack/product-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no |  |
| page | integer | no |  |
| active | boolean | no |  |
| from | string | no | The start date |
| to | string | no | The end date |

### Create Product
`POST https://www.apizie.tech/v1/payments:paystack/product-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Product
`GET https://www.apizie.tech/v1/payments:paystack/product-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update product
`POST https://www.apizie.tech/v1/payments:paystack/product-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Delete Product
`POST https://www.apizie.tech/v1/payments:paystack/product-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List Pages
`GET https://www.apizie.tech/v1/payments:paystack/page-list` (byok)

| Parameter | Type | Required | 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 |

### Create Page
`POST https://www.apizie.tech/v1/payments:paystack/page-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Page
`GET https://www.apizie.tech/v1/payments:paystack/page-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Page
`POST https://www.apizie.tech/v1/payments:paystack/page-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Check Slug Availability
`GET https://www.apizie.tech/v1/payments:paystack/page-check-slug-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Add Products
`POST https://www.apizie.tech/v1/payments:paystack/page-add-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### List Payment Request
`GET https://www.apizie.tech/v1/payments:paystack/payment-request-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no | Number of records to fetch per page |
| page | integer | no | The section to retrieve |
| customer | string | no | Customer ID |
| status | string | no | Invoice status to filter |
| currency | string | no | If your integration supports more than one currency, choose the one to filter |
| from | string | no | The start date |
| to | string | no | The end date |

### Create Payment Request
`POST https://www.apizie.tech/v1/payments:paystack/payment-request-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Payment Request
`GET https://www.apizie.tech/v1/payments:paystack/payment-request-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Payment Request
`POST https://www.apizie.tech/v1/payments:paystack/payment-request-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Verify Payment Request
`GET https://www.apizie.tech/v1/payments:paystack/payment-request-verify` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Send Notification
`POST https://www.apizie.tech/v1/payments:paystack/payment-request-notify` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Payment Request Total
`GET https://www.apizie.tech/v1/payments:paystack/payment-request-totals` (byok)

### Finalize Payment Request
`POST https://www.apizie.tech/v1/payments:paystack/payment-request-finalize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Archive Payment Request
`POST https://www.apizie.tech/v1/payments:paystack/payment-request-archive` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Fetch Settlements
`GET https://www.apizie.tech/v1/payments:paystack/settlements-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no |  |
| page | integer | no |  |

### Settlement Transactions
`GET https://www.apizie.tech/v1/payments:paystack/settlements-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no |  |
| page | integer | no |  |
| id | string | yes | Path parameter {id} |

### List Transfer Recipients
`GET https://www.apizie.tech/v1/payments:paystack/transferrecipient-list` (byok)

| Parameter | Type | Required | 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 |

### Create Transfer Recipient
`POST https://www.apizie.tech/v1/payments:paystack/transferrecipient-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Bulk Create Transfer Recipient
`POST https://www.apizie.tech/v1/payments:paystack/transferrecipient-bulk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Transfer recipient
`GET https://www.apizie.tech/v1/payments:paystack/transferrecipient-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Transfer recipient code |

### Update Transfer recipient
`POST https://www.apizie.tech/v1/payments:paystack/put-transferrecipient-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Transfer recipient code |
| body | object | no | Form fields as a JSON object |

### Delete Transfer Recipient
`POST https://www.apizie.tech/v1/payments:paystack/delete-transferrecipient-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Transfer recipient code |

### List Transfers
`GET https://www.apizie.tech/v1/payments:paystack/transfer-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no | Number of records to fetch per page |
| page | integer | no | The section to retrieve |
| status | string | no |  |
| from | string | no | The start date |
| to | string | no | The end date |

### Initiate Transfer
`POST https://www.apizie.tech/v1/payments:paystack/transfer-initiate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Finalize Transfer
`POST https://www.apizie.tech/v1/payments:paystack/transfer-finalize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Initiate Bulk Transfer
`POST https://www.apizie.tech/v1/payments:paystack/transfer-bulk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Transfer
`GET https://www.apizie.tech/v1/payments:paystack/transfer-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Transfer code |

### Verify Transfer
`GET https://www.apizie.tech/v1/payments:paystack/transfer-verify` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reference | string | yes |  |

### Export Transfers
`GET https://www.apizie.tech/v1/payments:paystack/transfer-download` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no | Number of records to fetch per page |
| page | integer | no | The section to retrieve |
| status | string | no |  |
| from | string | no | The start date |
| to | string | no | The end date |

### Resend OTP for Transfer
`POST https://www.apizie.tech/v1/payments:paystack/transfer-resend-otp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Disable OTP requirement for Transfers
`POST https://www.apizie.tech/v1/payments:paystack/transfer-disable-otp` (byok)

### Finalize Disabling of OTP requirement for Transfers
`POST https://www.apizie.tech/v1/payments:paystack/transfer-disable-otp-finalize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Enable OTP requirement for Transfers
`POST https://www.apizie.tech/v1/payments:paystack/transfer-enable-otp` (byok)

### Fetch Balance
`GET https://www.apizie.tech/v1/payments:paystack/balance-fetch` (byok)

### Balance Ledger
`GET https://www.apizie.tech/v1/payments:paystack/balance-ledger` (byok)

| Parameter | Type | Required | 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 |

### Create Charge
`POST https://www.apizie.tech/v1/payments:paystack/charge-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Submit PIN
`POST https://www.apizie.tech/v1/payments:paystack/charge-submit-pin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Submit OTP
`POST https://www.apizie.tech/v1/payments:paystack/charge-submit-otp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Submit Phone
`POST https://www.apizie.tech/v1/payments:paystack/charge-submit-phone` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Submit Birthday
`POST https://www.apizie.tech/v1/payments:paystack/charge-submit-birthday` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Submit Address
`POST https://www.apizie.tech/v1/payments:paystack/charge-submit-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Check pending charge
`GET https://www.apizie.tech/v1/payments:paystack/charge-check` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reference | string | yes |  |

### List Bulk Charge Batches
`GET https://www.apizie.tech/v1/payments:paystack/bulk-charge-list` (byok)

| Parameter | Type | Required | 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 |

### Initiate Bulk Charge
`POST https://www.apizie.tech/v1/payments:paystack/bulk-charge-initiate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Bulk Charge Batch
`GET https://www.apizie.tech/v1/payments:paystack/bulk-charge-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Batch code |

### Fetch Charges in a Batch
`GET https://www.apizie.tech/v1/payments:paystack/bulk-charge-charges` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Batch code |

### Pause Bulk Charge Batch
`GET https://www.apizie.tech/v1/payments:paystack/bulk-charge-pause` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Batch code |

### Resume Bulk Charge Batch
`GET https://www.apizie.tech/v1/payments:paystack/bulk-charge-resume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | yes | Batch code |

### Fetch Payment Session Timeout
`GET https://www.apizie.tech/v1/payments:paystack/integration-fetch-payment-session-timeout` (byok)

### Update Payment Session Timeout
`POST https://www.apizie.tech/v1/payments:paystack/integration-update-payment-session-timeout` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### List Refunds
`GET https://www.apizie.tech/v1/payments:paystack/refund-list` (byok)

| Parameter | Type | Required | 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 |

### Create Refund
`POST https://www.apizie.tech/v1/payments:paystack/refund-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch Refund
`GET https://www.apizie.tech/v1/payments:paystack/refund-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List Disputes
`GET https://www.apizie.tech/v1/payments:paystack/dispute-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no | Number of records to fetch per page |
| page | integer | no | The section to retrieve |
| status | string | no | Dispute Status. |
| transaction | string | no | Transaction ID |
| from | string | no | The start date |
| to | string | no | The end date |

### Fetch Dispute
`GET https://www.apizie.tech/v1/payments:paystack/dispute-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Dispute ID |

### Update Dispute
`POST https://www.apizie.tech/v1/payments:paystack/dispute-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Dispute ID |
| body | object | no | Form fields as a JSON object |

### Get Upload URL
`GET https://www.apizie.tech/v1/payments:paystack/dispute-upload-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Dispute ID |

### Export Disputes
`GET https://www.apizie.tech/v1/payments:paystack/dispute-download` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| perPage | integer | no | Number of records to fetch per page |
| page | integer | no | The section to retrieve |
| status | string | no |  |
| from | string | no | The start date |
| to | string | no | The end date |

### List Transaction Disputes
`GET https://www.apizie.tech/v1/payments:paystack/dispute-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Transaction ID |

### Resolve a Dispute
`POST https://www.apizie.tech/v1/payments:paystack/dispute-resolve` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Dispute ID |
| body | object | no | Form fields as a JSON object |

### Add Evidence
`POST https://www.apizie.tech/v1/payments:paystack/dispute-evidence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Dispute ID |
| body | object | no | Form fields as a JSON object |

### Match Service
`POST https://www.apizie.tech/v1/payments:paystack/verification-bvn-match` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Resolve BVN
`GET https://www.apizie.tech/v1/payments:paystack/verification-resolve-bvn` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bvn | string | yes |  |

### Resolve Account Number
`GET https://www.apizie.tech/v1/payments:paystack/verification-resolve-account-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_number | integer | no |  |
| bank_code | integer | no |  |

### Resolve Card BIN
`GET https://www.apizie.tech/v1/payments:paystack/verification-resolve-card-bin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bin | string | yes |  |

### List Countries
`GET https://www.apizie.tech/v1/payments:paystack/verification-list-countries` (byok)

### Fetch Banks
`GET https://www.apizie.tech/v1/payments:paystack/verification-fetch-banks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | no |  |
| pay_with_bank_transfer | boolean | no |  |
| use_cursor | boolean | no |  |
| perPage | integer | no |  |
| next | string | no |  |
| previous | string | no |  |
| gateway | string | no |  |

### List States (AVS)
`GET https://www.apizie.tech/v1/payments:paystack/verification-avs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | no |  |
| country | string | no |  |
| currency | string | no |  |

## Example
```
curl "https://www.apizie.tech/v1/payments:paystack/transaction-initialize" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Paystack API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/payments:paystack/transaction-initialize with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Paystack API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Paystack itself also needs your own key from paystack.co.

### Can AI agents use the Paystack API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key payments:paystack.

### What is the status of the Paystack API?
Needs your own provider key (bring your own key)