Mamo

This feature allows the merchant to hold funds during a payment process and decide later whether to capture or reverse the payment. This is particularly useful for scenarios where you want to authorize a payment but only complete the transaction once certain conditions are met.

The process is straightforward and revolves around a field called <code>hold_and_charge_later</code> in the <a href="https://mamopay.readme.io/reference/post_links" target="_blank" rel="nofollow noopener noreferrer">create payment link</a> API, followed by the options to capture or reverse the payment at a later stage using the <a href="https://mamopay.readme.io/reference/post_charges-chargeid-captures" target="_blank" rel="nofollow noopener noreferrer">capture</a> and <a href="https://mamopay.readme.io/reference/post_charges-chargeid-reverses" target="_blank" rel="nofollow noopener noreferrer">reverse</a> endpoints.

Create a Payment Link with <code>hold_and_charge_later: true</code>

Once the payment is complete, get the payment Id by <a href="https://mamopay.readme.io/reference/get_charges" target="_blank" rel="nofollow noopener noreferrer">fetching your transactions</a>, or using the predefined <code>redirect_url</code> passed in the request, or using a <a href="https://mamopay.readme.io/reference/post_webhooks" target="_blank" rel="nofollow noopener noreferrer">webhook</a> with the event <code>charge_authorized</code>.

When you're ready to capture/reverse the payment, pass the payment ID in the <code>chargeId</code> field accordingly.

curl --request POST \ --url https://business.mamopay.com/manage_api/v1/charges/&lt;chargeId&gt;/captures \ --header 'Authorization: Bearer &lt;your api key&gt;' \ --header 'Content-Type: application/json' \ --header 'accept: application/json'

curl --request POST \ --url https://business.mamopay.com/manage_api/v1/charges/&lt;chargeId&gt;/reverses \ --header 'Authorization: Bearer &lt;your api key&gt;' \ --header 'Content-Type: application/json' \ --header 'accept: application/json'

1. Create a Payment Link with <code>hold_and_charge_later: true</code>
 Once the payment is complete, get the payment Id by <a href="https://mamopay.readme.io/reference/get_charges" target="_blank" rel="nofollow noopener noreferrer">fetching your transactions</a>, or using the predefined <code>redirect_url</code> passed in the request, or using a <a href="https://mamopay.readme.io/reference/post_webhooks" target="_blank" rel="nofollow noopener noreferrer">webhook</a> with the event <code>charge_authorized</code>.
2. When you're ready to capture/reverse the payment, pass the payment ID in the <code>chargeId</code> field accordingly.
 Sample request:
 Capture:
 
 curl --request POST \ --url https://business.mamopay.com/manage_api/v1/charges/&lt;chargeId&gt;/captures \ --header 'Authorization: Bearer &lt;your api key&gt;' \ --header 'Content-Type: application/json' \ --header 'accept: application/json'
 
 Reverse:
 
 curl --request POST \ --url https://business.mamopay.com/manage_api/v1/charges/&lt;chargeId&gt;/reverses \ --header 'Authorization: Bearer &lt;your api key&gt;' \ --header 'Content-Type: application/json' \ --header 'accept: application/json'

E-commerce: Authorize payments at the time of order but capture funds only after shipping.

Service-based businesses: Hold funds during booking and capture them post-service delivery.

Rental services: Authorize insurance payments upon rental, and refund when the rented property/vehicle is safely returned, capture otherwise.

1. E-commerce: Authorize payments at the time of order but capture funds only after shipping.
2. Service-based businesses: Hold funds during booking and capture them post-service delivery.
3. Rental services: Authorize insurance payments upon rental, and refund when the rented property/vehicle is safely returned, capture otherwise.

Overview

How It Works

Sample request:

Use cases

FAQs

Can I hold funds in any currency?