This functionality allows merchants to selectively display specific payment methods on the paypage for individual orders. While currently, customers viewing a payment link can access all configured payment options, this feature enables merchants to curate and display only a chosen subset of these methods for a particular order.
How does it work?
Merchants now have the option to specify the desired payment methods using a new field in merchantAttributes called offerOnly during order creation. OfferOnly attribute accepts a comma-separated list of configured payment methods.
Below is the sample request while creating order
{
"action": "SALE",
"amount": {
"currencyCode": "AED",
"value": 1000
},
"emailAddress": "[email protected]",
"merchantAttributes": {
"maskPaymentInfo": true,
"paymentAttempts": "3",
"redirectUrl": "https://www.google.com",
"offerOnly": "VISA, MASTERCARD, TABBY"
}
}
Paypage with only VISA, MASTERCARD & TABBY displayed as per the above order request.
Accepted values for offerOnly attributes are VISA, MASTERCARD, AMERICAN_EXPRESS, DINERS_CLUB_INTERNATIONAL, DISCOVER, JCB, MADA, APPLE_PAY, CHINA_UNION_PAY, SAMSUNG_PAY, TABBY
Points to note:
- The values in offerOnly is case-sensitive and should be in uppercase.
- If any payment methods specified in offerOnly are not configured for the respective outlet and currency, the creation of the order will not be allowed.
- If the cardholder enters a card number associated with a scheme not listed in the offerOnly, the payment will be declined.