API Documentation
Core Resources
- Webhook
Checkout
- Session
Payments
- Payment Codes
- Payment Links
- Payment Pages
Transfers
- Payout
- Bulk Payout
Embedded Finance
- Financial Account
Extra Resources
- KYC Verification
- Financial Providers
- Available Countries
Payment Codes
Create Payment Code
POST
/
payment-codes
Copy
curl --request POST \
--url https://api.monime.io/payment-codes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'Monime-Space-Id: <monime-space-id>' \
--data '{
"name": "EDSA Office Top-up",
"mode": "oneTime",
"isActive": true,
"amount": {
"currency": "<string>",
"value": 123
},
"duration": "1h30m",
"customerTarget": {
"name": "Musa Kamara",
"reference": "0123456789",
"payingPhoneNumber": "078000000"
},
"financialTarget": {
"expectedPaymentCount": 10,
"expectedPaymentSum": {
"currency": "<string>",
"value": 123
}
},
"allowedProviders": [
"m17",
"m18"
],
"financialAccountId": "<string>",
"metadata": {}
}'
Copy
{
"success": true,
"messages": [
"<any>"
],
"result": {
"id": "pmc-TJh76H8hj778hftdtu66gjio",
"name": "Home EDSA Meter Top-up",
"mode": "oneTime",
"isActive": true,
"status": "pending",
"ussdCode": "\\*715\\*1\\*0123456789#",
"amount": {
"currency": "<string>",
"value": 123
},
"customerTarget": {
"name": "Musa Kamara",
"reference": "0123456789",
"payingPhoneNumber": "078000000"
},
"financialTarget": {
"expectedPaymentCount": 10,
"expectedPaymentSum": {
"currency": "<string>",
"value": 123
}
},
"allowedProviders": [
"m17",
"m18"
],
"progress": {
"isCompleted": true,
"totalPaymentCount": 123,
"totalPaymentSum": {
"currency": "<string>",
"value": 123
}
},
"financialAccountId": "<string>",
"expireTime": "2023-11-07T05:31:56Z",
"createTime": "2023-11-07T05:31:56Z",
"metadata": {}
}
}
Authorizations
Bearer HTTP authentication specified with the header Authorization: Bearer <access_token>
Headers
The value is the tenancy parameter that Monime used to determine which space the request is intended for.
Maximum length:
100
This header is used to uniquely identify a request, ensuring that the operation is not performed more than once during retries.
Maximum length:
64
Body
application/json
Response
200 - application/json
OK
The response is of type object
.
Was this page helpful?
Copy
curl --request POST \
--url https://api.monime.io/payment-codes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'Monime-Space-Id: <monime-space-id>' \
--data '{
"name": "EDSA Office Top-up",
"mode": "oneTime",
"isActive": true,
"amount": {
"currency": "<string>",
"value": 123
},
"duration": "1h30m",
"customerTarget": {
"name": "Musa Kamara",
"reference": "0123456789",
"payingPhoneNumber": "078000000"
},
"financialTarget": {
"expectedPaymentCount": 10,
"expectedPaymentSum": {
"currency": "<string>",
"value": 123
}
},
"allowedProviders": [
"m17",
"m18"
],
"financialAccountId": "<string>",
"metadata": {}
}'
Copy
{
"success": true,
"messages": [
"<any>"
],
"result": {
"id": "pmc-TJh76H8hj778hftdtu66gjio",
"name": "Home EDSA Meter Top-up",
"mode": "oneTime",
"isActive": true,
"status": "pending",
"ussdCode": "\\*715\\*1\\*0123456789#",
"amount": {
"currency": "<string>",
"value": 123
},
"customerTarget": {
"name": "Musa Kamara",
"reference": "0123456789",
"payingPhoneNumber": "078000000"
},
"financialTarget": {
"expectedPaymentCount": 10,
"expectedPaymentSum": {
"currency": "<string>",
"value": 123
}
},
"allowedProviders": [
"m17",
"m18"
],
"progress": {
"isCompleted": true,
"totalPaymentCount": 123,
"totalPaymentSum": {
"currency": "<string>",
"value": 123
}
},
"financialAccountId": "<string>",
"expireTime": "2023-11-07T05:31:56Z",
"createTime": "2023-11-07T05:31:56Z",
"metadata": {}
}
}
Assistant
Responses are generated using AI and may contain mistakes.