Skip to main content
Idram lets customers complete payment from their Idram wallet. To activate it, obtain merchant credentials from Idram and connect them in Lynq Dashboard.

What you need from Idram

Contact Idram and request merchant API access. The connection form requires: Confirm with Idram which credentials apply to test and live processing.

Configure Idram

Select the environment

Open Lynq Dashboard and choose Test mode or Live mode in the header.

Open Idram

Go to Payment methods, find Idram, and choose Configure.

Enter the credentials

Enter the EDP ID and secret key exactly as supplied. Choose Save and enable.

Confirm the connection

The Idram entry should show as enabled. Idram will appear in new checkout sessions created in this environment.
The secret key is encrypted when saved and is not displayed again. When updating the connection, enter the EDP ID and secret key together.

Customer flow

  1. The customer chooses Idram in Lynq Checkout.
  2. Checkout starts the Idram wallet flow.
  3. The SDK handles the wallet handoff and return internally.
  4. Checkout reports a merchant-actionable result to your browser.
  5. Lynq sends payment_intent.succeeded to your webhook after successful completion.
Do not fulfil the order from the wallet return or browser callback. Wait for the verified webhook.

Verify the setup

  • Create a Payment Intent using a secret key from the same environment.
  • Mount Checkout with the matching publishable key and client secret.
  • Confirm Idram appears as an available method.
  • Complete the wallet flow using the test details supplied by Idram.
  • Verify the payment and webhook delivery in Dashboard.

Troubleshooting

Confirm Idram is enabled for the Payment Intent’s environment and that Checkout uses the matching publishable key.
Re-enter the complete EDP ID and current secret key. If the secret was rotated, replace both fields in Dashboard.
Keep the order pending and rely on the webhook for final state. A browser return is not authoritative payment confirmation.
For shared environment and connection rules, see Payment methods.
Last modified on August 8, 2026