Reduce transaction disruption in making recurring payments by enabling your customer to create their Maya wallet link.
demo website (beta version) and see how Link a Wallet and Payments work.Go to our
Step 1: Setup your Maya Business Manager Account
Before you could implement the Link Maya Wallet to your websites, you must register and setup your Maya Business Manager Account.
Step 2: Build your pages
Create a Link Maya Wallet button on your website that will allow customers to initiate the wallet linking.
<html> <head> <title>Wear Vamos</title> </head> <body> <form action="/link-maya-wallet" method="POST"> <button type="submit">Link Maya Wallet</button> </form> </body> </html>
Host pages on your website that will reflect the payment status to customers.
<html> <head><title>Wallet linked</title></head> <body> <h1>Wallet linked</h1> </body> </html>
Step 3: Complete the wallet linking
Handle the 'Link Maya Wallet' button event by calling the
POST /payby/v2/paymaya/link endpoint to redirect user to the Maya Connect Login page for authentication and creation of the wallet link.
Your system must define the redirectURL when calling this endpoint.
URL of the page where your customers will be redirected after a successful payment.
URL of the page where your customers will be redirected to when the payment fails.
URL of the page where your customer will be redirected when they cancel a payment.
This endpoint will return a
linkId – a unique identifier of a successful Maya Wallet link which you can use for managing the wallet link or execute the current and future payments on-behalf-of the user.
At this point you should be able to redirect session to Maya’s login page by clicking the button.
- Click "Link Maya Wallet" button
- You get redirected to Maya's Single Sign-on Page
- You will have to use a test Maya account Sandbox Credentials and Cards.
- On successful link, it will redirect to your success page.
After acquiring the
linkId, your system can use it to manage wallet link.
Get Wallet Link
Use this endpoint for your system to retrieve the details of a linked Maya wallet account.
Delete Wallet Link
Use this endpoint to deactivate a Maya wallet link.
When user had successfully done the wallet link and
linkId was generated, use the
linkId to execute current and future payments on-behalf-of the user.
Updated 4 months ago