Skip to main content
Return to Dandelion Payments

Pay Money API: cash pickup

  • Updated

The "Search Cash pickup Order" endpoint allows the paying partner to retrieve transaction information for orders that are ready to be paid out.

Using this endpoint, along with the transaction details, we can get the necessary fields to process the payout and determine the available payout currencies.

To verify the details in the Dandelion system, follow these steps when a user provides the order PIN:

  1. The customer visits the paying partner location and provides the order PIN.
  2. The "Search Cash pickup Order" endpoint is called to verify the transaction details.
  3. After confirming the transaction and required details, use the TransRefID to confirm the payment.
  4. Call the "Pay Cash pickup Order" endpoint to process the payout.

By following this workflow, we can ensure a smooth and secure payout transaction process for our customers and partners.

Cash Pickup Flow .png

 

DNVerifyAndConfirmOrderPaid.jpg


Reverse Payment

The Cancel payment of a CashPickUp order operation allows for the reversal of actions taken by Pay Cash pickup Order in case of errors or issues caused by Dandelion or the payment partner. These issues could include network interruptions, micro-cuts, power outages, and other related problems.

When Cancel payment of a CashPickUp order is called, the state of the order in Dandelion changes from "Paid" to "Available for payout". There are two scenarios where this operation should be used:

  1. When the payment partner calls Pay Cash pickup Order, but a TimeOutException is returned by the web service. In this case, the payment partner is unsure if the order has been saved as paid by Dandelion. To resolve this, Cancel payment of a CashPickUp is called using the OrderPaidTranRefID field obtained from the TransRefID field of the Search Cash pickup Order response. If the service returns a TimeOutException again in response to the Cancel payment of a CashPickUp call, recall the operation several times until a valid response is received.
  2. When the payment partner receives a correct response from Pay Cash pickup Order but encounters an exception while trying to save the order as paid in their database. In this scenario, Cancel payment of a CashPickUp is called using the OrderPaidTranRefID field obtained from the TransRefID field of the Pay Cash pickup Order response.

By following these steps, we can make sure that any errors or issues with the transaction process are addressed and resolved quickly for a smooth and reliable experience for our customers and partners.

Related articles