Skip to main content
Card payments let customers pay with Visa, Mastercard, and ArCa cards in hosted Checkout. In test mode Lynq simulates them, so there is nothing to connect: see Test cards. For live payments, which aren’t available yet, you connect VPOS credentials from Ameriabank. For an overview of how Lynq works with the VPOS you already have, see Bank VPOS checkout without the redirect. For what customers see, see card payments.

​
What you need from Ameriabank

Contact Ameriabank and request VPOS access for your merchant.

​
Connect Card payments

Open Card payments in live mode

In Lynq Dashboard, choose Live mode, go to Payment methods, find Card payments, and choose Configure.

Enter the VPOS credentials

Enter the Terminal ID, username, and password exactly as supplied. Choose Save and enable.

Confirm the connection

Card payments shows as enabled and appears in new live checkout sessions. Disable it to stop offering it; payment history is kept.
Credentials are encrypted when saved and secret fields are never displayed again. To update the connection, enter all three values again.

​
What the customer does

  1. The customer chooses Card in Lynq Checkout and enters the cardholder name, card number, expiry date, and security code inside the Lynq-hosted iframe.
  2. If the bank requires 3D Secure, Lynq.js opens and completes it. Do not implement the redirect yourself.
  3. Checkout returns a result to your browser, and Lynq sends payment_intent.succeeded to your webhook.
Your page receives only a summary such as the brand and last four digits. Card numbers and security codes never reach it.

​
Troubleshooting

In live mode, confirm Card payments is enabled. In either mode, check that Checkout uses a publishable key from the same mode as the Payment Intent.
Re-enter all values without leading or trailing spaces. If Ameriabank rotated the password, use the current Terminal ID, username, and new password together.
Last modified on November 11, 2026