Direct Debit

A collection of endpoints for managing Direct Debit

Copy link Trigger Activation Charge

Trigger activation charge for specified customers

Request Body

customer_idsrequiredarray[integer]
Array of customer IDs to trigger activation charge for

Response

200Direct Debit Activation Charge response
statusrequiredboolean
messagerequiredstring
PUT/directdebit/activation-charge
curl https://api.paystack.co/directdebit/activation-charge \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_ids": []
  }' \
  -X PUT
import { 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.data
Response
{
  "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

cursorstring
The cursor value of the next set of authorizations to fetch. You can get this from the meta object of the response
statusstring
Filter by the authorization status
Enumpendingactiverevoked
per_pageinteger
The number of authorizations to fetch per request

Response

200Customer Fetch Mandate Authorizations response
statusrequiredboolean
messagerequiredstring
datarequiredarray[object]
metarequiredobject
4 object properties
per_pagerequiredinteger
nextstring
countrequiredinteger
totalrequiredinteger
GET/directdebit/mandate-authorizations
curl 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.data
Response
{
  "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
}