POST
/
collections
cURL
curl --request POST \
  --url https://api.development.mona.ng/collections \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "maximumAmount": "600",
  "debitType": "MERCHANT",
  "startDate": "2025-05-22T05:43:00",
  "expiryDate": "2025-06-19T08:42:00",
  "reference": "Testing Mona Scheduled Collection--Succeed",
  "schedule": {
    "type": "SCHEDULED",
    "frequency": "WEEKLY",
    "amount": "500",
    "entries": [
      {
        "date": "2025-05-22T05:43:00",
        "amount": "200"
      }
    ]
  },
  "agentId": "507f1f77bcf86cd799439011"
}'
{
  "success": true,
  "data": {
    "id": "68554203285367d030f8d398",
    "isConsented": false,
    "collection": {
      "maxAmount": "10000",
      "expiryDate": "2025-06-24T00:00:00.000Z",
      "startDate": "2025-06-20T13:12:03.075Z",
      "monthlyLimit": "10000",
      "schedule": {
        "type": "SCHEDULED",
        "frequency": null,
        "entries": [
          {
            "date": "2025-06-22T11:11:00.000Z",
            "amount": "10000"
          }
        ],
        "amount": null
      },
      "reference": "LOAN",
      "status": "NOT_STARTED",
      "lastCollectedAt": null,
      "nextCollectionAt": "2025-06-20T13:12:03.075Z",
      "debitType": "MERCHANT",
      "loanLinkToken": "68554203285367d030f8d394"
    },
    "createdAt": "2025-06-20T11:12:03.816Z",
    "updatedAt": "2025-06-20T11:12:03.816Z"
  }
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Collection creation parameters

​
maximumAmount
string
required

The maximum amount for the collection in kobo (Nigerian minor currency unit)

Example:

"600"

​
debitType
enum<string>
required

Type of debit initiation

Available options:
MONA,
MERCHANT
Example:

"MERCHANT"

​
startDate
string<date-time>
required

Start date for the collection

Example:

"2025-05-22T05:43:00"

​
expiryDate
string<date-time>
required

Expiry date for the collection

Example:

"2025-06-19T08:42:00"

​
schedule
object
required

Schedule configuration for the collection

​
reference
string

Optional reference for the collection

Example:

"Testing Mona Scheduled Collection--Succeed"

​
agentId
string

ObjectId of the user associated with your company that is the agent processing the collection

Example:

"507f1f77bcf86cd799439011"

Response

Collection created response

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
data
object
required