1. The customer fills out your hosted card form.
2. Your platform (The API Consumer) sends the acquired card information to Maya’s Create Payment Token endpoint, to request card tokenization.
3. Maya Vault encrypts and stores card details, generating a paymentTokenId to identify the vaulted card.
4. Maya returns the paymentTokenId to your platform.
5. Your platform initiates the payment using the paymentTokenId via the Create Payment endpoint.
6. When Maya receives a Create Payment request, it will create a payment record with FOR_AUTHENTICATION status.
7. Maya then responds with the payment details and the verificationUrl.
8. Your platform redirects the customer to the verificationUrl obtained from the payment creation (Step 5).
9. The customer complies and completes the verification process, based on the Issuing bank rules of their card.
10. Once the transaction is authorized, Maya will process the payment and update the status of the payment record based on the result, either to PAYMENT_SUCCESS or PAYMENT_FAILED.
11. Upon successful payment, Maya Vault will redirect the customer to your success page as provided in the redirectUrl during the payment creation (Step 5).
12. Maya Vault sends a webhook notification to your platform.
13. Your platform acknowledges the webhook payload and returns 200 OK. Please avoid processing complex logic before you reply to webhook to prevent timeouts.
14. Your platform parses and processes the webhook payload.
15. Your platform notifies the customer of the updates of the transaction.

1. Create your Card Details form

Create a card details form for your customers to input their payment information, adhering to Maya Vault's specifications. Refer to the Create Payment Token for the required card information.

2. Create your Response pages

Every payment state should show an appropriate web page for the customer to know the status of their transaction. You need to host these pages on your website.

Created URLs will be used in the redirectUrl object on the Create Customer Payment transaction request defining where the customer will be redirected when processing the transaction.

Tokenize the customer’s card payment information by calling the Create Payment Token endpoint. After a successful call, you'll receive a paymentTokenId. You will need this ID to create a payment.

Step 1: Create Payment

To complete the payment transaction, your application should call the Create Payment endpoint providing the following:

• paymentTokenId from the Create Payment Token endpoint
• all of the other required transaction details.

The Create Payment endpoint will return a verificationUrl.

Step 2: Redirect Customer to verificationUrl

Redirect the user to the verificationUrl to proceed with the card verification and complete the payment. This will prompt the customer for the 3DS authentication stage.