Direct Debit
A collection of endpoints for managing Direct Debit
Copy link Trigger Activation Charge
Trigger activation charge for specified customers
Request Body
Array of customer IDs to trigger activation charge for
Response
200Direct Debit Activation Charge response
PUT
/directdebit/activation-chargecurl https://api.paystack.co/directdebit/activation-charge \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_ids": []
}' \
-X PUTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.directDebit.triggerActivationCharge({
customer_ids: []
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.direct_debit.trigger_activation_charge({
customer_ids: []
})
puts response.dataResponse
{
"status": true,
"message": "Mandate is queued for retry"
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link List Mandate Authorizations
Get a list of all the direct debit mandates on your integration
Query Parameters
The cursor value of the next set of authorizations to fetch. You can get this from the meta object of the response
Filter by the authorization status
Enumpendingactiverevoked
The number of authorizations to fetch per request
Response
200Customer Fetch Mandate Authorizations response
4 object properties
GET
/directdebit/mandate-authorizationscurl https://api.paystack.co/directdebit/mandate-authorizations \
-H "Authorization: Bearer YOUR_SECRET_KEY"import { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.directDebit.listMandateAuthorizations({
cursor: "CURSOR",
status: "pending"
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.direct_debit.list_mandate_authorizations({
cursor: "CURSOR",
status: "pending"
})
puts response.dataResponse
{
"status": true,
"message": "Mandate authorizations retrieved successfully",
"data": [
{
"id": 112244,
"status": "active",
"mandate_id": 1560169,
"authorization_id": 1069309917,
"authorization_code": "AUTH_lEt8QgrSfW",
"integration_id": 463433,
"account_number": "0123456789",
"bank_code": "058",
"bank_name": "Guaranty Trust Bank",
"customer": {
"id": 28958104,
"customer_code": "CUS_5kye9bc41uw15pb",
"email": "[email protected]",
"first_name": "Booker",
"last_name": "Jones"
},
"authorized_at": "2025-06-23T12:47:10.632Z"
}
],
"meta": {
"per_page": 10,
"next": "MTI1OTc=",
"count": 10,
"total": 40
}
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}