> ## Documentation Index > Fetch the complete documentation index at: https://docs.mobipurse.com/llms.txt > Use this file to discover all available pages before exploring further. # Request a disbursement > Initiates a disbursement to send funds to a recipient's mobile wallet. The disbursement will be processed and you'll receive the status immediately in the response. Webhook notifications will be sent for any status changes. ## OpenAPI ````yaml api-reference/openapi-3.1.yml post /v1/disbursements openapi: 3.0.3 info: title: Mobipurse API description: > Mobipurse is a universal wallet platform that enables merchants to accept payments and make disbursements to customers across any country. ## Authentication All API requests require authentication using an API key. Include your API key in the `x-api-key` header. ## Environments - **Staging**: `https://staging-api.mobipurse.com` - **Production**: `https://api.mobipurse.com` ## Support - Email: support@mobipurse.com - Dashboard: https://mobipurse.com version: 1.0.0 contact: email: support@mobipurse.com servers: - url: https://staging-api.mobipurse.com description: Staging server - url: https://api.mobipurse.com description: Production server security: - ApiKeyAuth: [] tags: - name: Checkouts description: Operations for creating and managing payment checkouts - name: Disbursements description: Operations for making disbursements to recipients paths: /v1/disbursements: post: tags: - Disbursements summary: Request a disbursement description: > Initiates a disbursement to send funds to a recipient's mobile wallet. The disbursement will be processed and you'll receive the status immediately in the response. Webhook notifications will be sent for any status changes. operationId: createDisbursement requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateDisbursementRequest' examples: basic: summary: Basic disbursement value: reference: 2a59004d-72a9-4bdc-9893-abff8fa6ffb4 amount: 10000 phoneNumber: '2257038102473' country: CI currency: XOF webhookURL: https://webhook.site/100ebe83-961d-4096-8741-05772dafcfa1 responses: '200': description: Disbursement created successfully content: application/json: schema: $ref: '#/components/schemas/CreateDisbursementResponse' examples: success: summary: Successful disbursement creation value: statusCode: 200 data: reference: DMBD20251110155014KVAZR merchantsReference: 5f86ad3c-2d4a-401e-959c-3e0db463b175 amount: 10000 fee: 480 status: success '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '409': $ref: '#/components/responses/Conflict' '422': $ref: '#/components/responses/UnprocessableEntity' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateDisbursementRequest: type: object required: - reference - amount - phoneNumber - country - currency properties: reference: type: string description: >- Unique merchant reference for the disbursement. Must be unique for each disbursement. example: 2a59004d-72a9-4bdc-9893-abff8fa6ffb4 amount: type: integer description: >- The amount to disburse in the lowest currency denomination (e.g., 10000 for 100.00) example: 10000 minimum: 1 phoneNumber: type: string description: Recipient's phone number in international format without the + sign example: '2257038102473' pattern: ^[0-9]{10,15}$ country: type: string description: The 2-character ISO country code example: CI pattern: ^[A-Z]{2}$ currency: type: string description: The 3-character ISO currency code example: XOF pattern: ^[A-Z]{3}$ webhookURL: type: string format: uri description: URL to receive webhook notifications for disbursement events example: https://webhook.site/100ebe83-961d-4096-8741-05772dafcfa1 CreateDisbursementResponse: type: object properties: statusCode: type: integer example: 200 data: type: object properties: reference: type: string description: Unique reference generated by Mobipurse example: DMBD20251110155014KVAZR merchantsReference: type: string description: Merchant's reference for the disbursement example: 5f86ad3c-2d4a-401e-959c-3e0db463b175 amount: type: integer description: The disbursement amount example: 10000 fee: type: integer description: The transaction fee example: 480 status: type: string enum: - pending - success - failed description: Current status of the disbursement example: success Error: type: object properties: statusCode: type: integer example: 400 message: type: string example: Invalid request parameters error: type: string example: Bad Request responses: BadRequest: description: Bad request - Invalid parameters content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 400 error: Invalid request parameters Unauthorized: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 401 error: Invalid API key Conflict: description: Conflict - Duplicate reference content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 409 error: A disbursement with this reference already exists UnprocessableEntity: description: Unprocessable entity - Validation failed content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 422 error: Invalid phone number format InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 500 error: Internal Server Error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key for authentication. Generate this from your Mobipurse dashboard under Settings → API Keys. ````