Create Payment Link

post https://sandbox.dev.business.mamopay.com/manage_api/v1/links

API to generate vanilla and subscription payment links.

Payment Status

Once your customer completes a payment, the redirect URL will be appended with the following params

createdAt: The date the charge was captured at
paymentLinkId: The payment link id
status: indicates the payment status, whether captured or failed
transactionId: The transaction / charge id related to the payment

You may also get notified about a payment's status by setting up a webhook. Details here

A third approach to check the transaction status is by calling our transaction info API here

Sample redirect url after a successful payment
https://www.mamopay.com/?createdAt=2023-08-09-16-42-35&paymentLinkId=MB-LINK-3216D27C9D&status=captured&transactionId=MPB-CHRG-BEE56990A9

For Payment Testing

To make payments with different use cases on the test environment, you can use the card details below:

Card Number	Payment Status	3DS	Address Required	Country
4659 1055 6905 1157	Success	X	X	GB
4242 4242 4242 4242	Success	✓	X	GB
4111 1111 1111 1111	Success	✓	✓	US
4567 3613 2598 1788	Fail	X	X	GB
4095 2548 0264 2505	Fail	X	✓	US

CVV: 123
Expiry: 01/28

3DS

If prompted for a password, enter Checkout1!

Subscriptions

When setting up subscriptions, if both end_date and payment_quantity were defined, end_date takes precedence.

Body Params

title

string

required

length between 1 and 75

Defaults to Chocolate Box - Small

The title of the payment link

description

string

length ≤ 75

Defaults to 12pcs Chocolate Box

Payment description. This will appear on the payment checkout page.

capacity

integer

The number of times a payment link can be used, if null the link can be used indefinitely. The capacity will be ignored when the subscription params exist.

active

boolean

Defaults to true

return_url

uri

Defaults to https://myawesomewebsite.com/paymentSuccess

The URL which the customer will be redirected to after a successful payment.

failure_return_url

uri

Defaults to https://failureurl.com/paymentFailure

The URL which the customer will be redirected to after a failure payment.

processing_fee_percentage

number

≥ 2

Defaults to 3

amount

number

≥ 2

Defaults to 119.99

amount could be 0 with save_card 'required' option for card verification

amount_currency

string

Defaults to AED

link_type

string

Defaults to standalone

Type of link to be created.

enable_tabby

boolean

Defaults to false

Enables the ability for customers to buy now and pay later.

enable_message

boolean

Defaults to false

Enables the ability for customers to add a message during the checkout process.

enable_tips

boolean

Defaults to false

Enables the tips option. This will be displayed on the first screen.

save_card

string

Defaults to off

Allows the merchant to enable the option to store card details to be used later on for Merchant Initiated Transactions.

enable_customer_details

boolean

Defaults to false

Enables adding customer details such as the name, email, and phone number. This screen will be displayed before the payment details screen.

enable_quantity

boolean

Defaults to false

When enabled, customers can specify the number of items they intend to purchase. This quantity will serve as a multiplier for the base amount.

enable_qr_code

boolean

Defaults to false

Adds the ability to verify a payment through a QR code.

send_customer_receipt

boolean

Defaults to false

Enables the sending of customer receipts.

payment_methods

array

An array of the accepted payment methods, with 'card' always included as the default option, and wallet for Apple Pay and Google Pay. Example to accept all: ['card', 'wallet']

payment_methods

rules

object

Setting the rule for payment link

subscription

object

to be populated if this payment link is for a recurring payment. Otherwise, this property can be left out. REQUIRES Premium Business Plan to be enabled.

first_name

string

The first name of customer which will pre-populate in card info step.

last_name

string

The last name of customer which will pre-populate in card info step.

string

The email of customer which will pre-populate in card info step.

custom_data

object

external_id

string

The external ID of your choice to associate with payments captured by this payment link.

hold_and_charge_later

boolean

Defaults to false

Indicates whether to place the payment on hold and charge it later using the "captures" API.

payouts_share

object

Headers

Content-Type

string

Authorization

string

Responses

404

Invalid request

500

Unexpected error

200Successful response

403Unauthorised

422Unprocessable entity