Send Money to Paybill / Till Numbers (KSH)
Money can be moved from your Marasoft Pay balance to a Paybill / Till KSH account by simply sending a post request with the required parameters to the endpont https://api.marasoftpay.live/mobile_money/send/
How to integrate
This integration can be completed in 2 easy steps:
1. Get bank codes or mobile money codes of the recipient's financial institutions with the get banks/mobile-money api
2. Post required data to the create transfer endpoint
Usage
Required Parameters
| Parameter | Required? | Description |
|---|---|---|
| enc_key | Yes | Your encryption key from MarasoftPay. Get it from your dashboard. Always make sure sensitive details like your encryption key is not in a visible area on your website, app or desktop application |
| secret_key | Yes | Your secret key is to be set from your Marasoft dashboard under the API section. Transfers will not be processed from your account if this parameter is not included. Learn more |
| network_code | Yes | A Network code is a unique identification code for a particular MoMo network. These codes are used when transferring money between momo networks and also can be used to exchange messages between them, we would provide you with an api for the list bankcodes. |
| business_no | Yes | Paybill / Till number of the receiver / customer / business |
| business_acc | No | This is for Paybill only. The account number for the paybill of the receiver / customer / business |
| type | Yes | This is to specify the type of transaction. Allowed values are: PAYBILL or TILL |
| transactionRef | Yes | a unique reference code to identify the transfer (if you don't supply one, we will generate one for you). |
| amount | Yes | Amount (in the lowest currency value - kobo, pesewas or cent) you are debiting customer. Do not pass this if creating subscriptions. |
| currency | Yes | Allowed values are: KSH |
| beneficiary_name | No | Field containing the receivers name. |
| description | No | Field containing the description you want recorded with the transaction. Fields within this key will show up on merchant receipt and within the transaction information on the Marasoft Dashboard. |
Important notes
1. Details of all funds sent out of your account are accessible via the transfer section on the dashboard and payout history api
2. Webhooks for transfers are sent to your transfer webhook url.
Handling Webhooks
After a payment has been successfully processed, Marasoft Pay will send a webhook notification to the URL that you specify. For more information on how to utilize webhooks, please refer Webhooks section of this documentation