---
title: "Request Mandate Approval"
method: POST
path: "/customers/crdb-direct-debit-mandate"
tags: ["CRDB Direct Debit"]
---

# Request Mandate Approval

`POST /customers/crdb-direct-debit-mandate`

Request CRDB Direct Debit mandate approval and create the linked payment schedule.

## Request body

- object
  - `customer` object, required
    - `fullName` string, required — Full name of the customer
    - `email` string — Customer email address
    - `phoneNumber` string — Customer phone number (optional contact number)
  - `phoneNumber` string, required — Customer's SimBanking-registered phone number for the debit account. 12 digits, starts with country code, no plus sign.
  - `debitAccount` string, required — CRDB account number to debit
  - `startDate` string, required — Mandate start date (DD-MM-YYYY or YYYY-MM-DD)
  - `endDate` string, required — Mandate end date (DD-MM-YYYY or YYYY-MM-DD)
  - `frequencyType` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', required — Installment frequency type
  - `frequency` number — Frequency multiplier (default: 1). Example: frequencyType=WEEKLY, frequency=2 means every 2 weeks
  - `installmentAmount` number, required — Amount to debit per installment (must be positive)
  - `mandateCallbackUrl` string, uri, required — URL where mandate status callbacks (ACTIVE, REJECTED, CANCELLED) will be sent
  - `billDetails` string — Optional description of the bill or mandate

## Response `200`

Mandate request accepted

- object
  - `mandateRequestId` string — Unique identifier for the mandate request
  - `mandateStatus` string — Current status of the mandate (typically REQUESTED)
  - `paymentsTotalAmount` number — Total amount scheduled over the mandate period
  - `paymentsInstallments` number — Total number of installments scheduled

## Other responses

- `400` — Validation or service error
- `401` — Unauthorized

---

[API](https://skmtc.net/clickpesa/apis/core-api-openapi-specification.md) · [All operations](https://skmtc.net/clickpesa/apis/core-api-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickpesa/core-api-openapi-specification/versions/9f70f35c5590/schema)