1. Download and receive a a bank deposit and Mobile Wallet
Once a transaction has been sent succesfully, it will be queued for payment processing by the paying partner. To retrieve these transactions, the paying partner must periodically call the "Downloadable orders ready to be paid " endpoint. Please note that each transaction can only be downloaded once. All available transactions will be downloaded at the same time.
After downloading the transactions, the paying partner must immediately update their status to "RECEIVED" using the "Update status of downloaded orders" endpoint. This will inform Dandelion that the partner has received the transactions and will proceed with the payment process.
2. How to pay a bank deposit and Mobile Wallet
After the partner has received and confirmed the transactions by notifying them through the API as "RECEIVED" , the next step is to mark them as paid using the "Update status of downloaded orders" endpoint with the "PAID" status. This marks the final step in the payment process, where the partner credits the funds into the receiver's account.
3. How to cancel a bank deposit and Mobile Wallet
A sender can ask to cancel their transaction through the sending agent system or by contacting Dandelion Customer Care.
Whether the transaction can be cancelled or not depends on the confirmation of the paying partners who process the payment.
Before depositing the funds into the receiver's bank account, the paying partners must retrieve the cancellation requests by calling the "Retrieve cancellations requests of already downloaded orders" endpoint.
If there are any pending cancellations when that endpoint is called, the paying partner must decide whether to accept or reject the cancellation request using "Cancel Order" with the below table values.
| Response code | Response description | Scenarios |
|
1000 |
Accepted |
Cancellation request accepted as order has not been paid yet. |
| 2000 |
Rejected - Order Not Found |
Cancellation request is rejected as the order is not in downloadable list. |
| 2001 |
Rejected - Order Already Paid |
Cancellation request is rejected as the order has already been paid out. |
| 2002 |
Rejected - Order Already Cancelled |
Cancellation request is rejected as the order has already been cancelled. |
| 2003 |
Rejected - Other |
Cancellation request is rejected for other reason |
If the cancellation request is accepted, the partner must then update the transaction status to "CANCELED" using the "Update status of downloaded orders" endpoint.
4. How to reject a bank deposit or Mobile Wallet payment
Some transactions may be rejected by the paying agent if they do not meet the partner's requirements. These transactions will not be processed. The rejection must be communicated through "Update status of downloaded orders" with the status "REJECTED".