What we do
Tools
Industries
Department
How we workLet's talk →
Home/Adyen/Adyen Pay by Link for Phone Orders and Invoices
Adyen

Sending an Adyen Pay by Link Request and Knowing When It's Been Paid

A customer rings to place an order, or an invoice is due, and there's no checkout page for them to use. Pay by Link gives you a URL that opens an Adyen-hosted payment page for a set amount and reference. Staff can make one by hand or your own system can create it through the API, and two defaults catch a lot of people out: the link lasts 24 hours, and it takes one payment.

The Customer Area form or the /paymentLinks API

By hand

Customer Area form

  • Go to Payments, then Payment links, then Create payment link, on the right merchant account.
  • Needs the Pay by Link Interface role.
  • Fill in the merchant reference, amount, shopper country, description, link type and how long it stays valid.
  • Press Copy link and send it, or use the payment link email if your account has that turned on.
From your system

POST /paymentLinks

  • Send merchantAccount, reference and amount (currency plus value in minor units, so 10.00 EUR is 1000).
  • Add expiresAt for a longer window, or reusable: true for a link many people can pay.
  • Read a link's status any time with GET /paymentLinks/{linkId}.
  • Cancel one by sending PATCH /paymentLinks/{linkId} with status set to expired.

A few links a week from the phones: the form is fine. Once links come off invoices or orders held in another system, the API stops anyone retyping an amount or a reference.

One invoice, one link, one record marked paid

  1. 1

    Use the invoice or order number as the reference

    The merchant reference is what ties a payment back to what it was for. An invoice number your accounting system already knows makes every later step easier.

  2. 2

    Set the expiry to match your terms

    Links expire after 24 hours unless you change it, and the longest you can set is 70 days from when the link was created. A 30-day invoice needs a 30-day link.

    Watch for: five failed payment attempts on one link expire it early, whatever date you set.

  3. 3

    Send it however you reach that customer

    It's an ordinary URL, so it can go by text, email, chat or be read out over the phone.

  4. 4

    Listen for the AUTHORISATION webhook

    It carries the result in success, the payment's pspReference, and additionalData.paymentLinkId so you know which link was paid.

    Watch for: a status of Payment pending. Some methods finish later, so wait for the result before you mark anything paid.

  5. 5

    Mark it paid in your own system

    Adyen records the payment. Your invoicing or order system only learns about it if something passes the webhook on and updates the right record.

When a payment link confuses the customer or the team

The link ran out before they opened it

How you'll know: The customer says the page shows the link as expired.

Fix: The 24-hour default was left in place. Set the service date (or expiresAt) to the payment terms, and send a fresh link for this one.

A reusable link went out for a one-off invoice

How you'll know: Two payments came in against one invoice, and the link still shows as Active.

Fix: Keep reusable links for things many people pay, like donations or event tickets. They only ever show Active or Expired, never Completed.

An old link can't be found

How you'll know: Someone searches the Payment links list for last spring's deposit and it isn't there.

Fix: The list shows links created in the last 90 days, and links are removed three months after they're made. Store the link ID and its status in your own system when you create it.

A new starter can't create links

How you'll know: The Create payment link button is missing for them.

Fix: Ask an admin to give them the Pay by Link Interface role.

Adyen payment link questions

How do I create a Pay by Link payment in Adyen?

Either in the Customer Area under Payments, Payment links, Create payment link, or with a POST /paymentLinks request that includes your merchant account, a reference and the amount. Both give you a URL to send to the customer.

Can I send a Pay by Link payment by text message?

Yes. Copy the link and paste it into a text, a chat or an email. Adyen can also email the request for you if the payment link email option is enabled on your account.

Does Pay by Link work for phone orders where I don't have the customer's card details?

That's one of the best uses for it. Take the order on the call, send the link while they're still on the line, and they type their own card details into Adyen's hosted page. Nobody reads a card number aloud.

Is a Pay by Link transaction the same as Adyen Checkout?

The money ends up in the same place, but the route differs. Checkout puts Drop-in or Components inside your own site or app. Pay by Link sends the shopper to a standalone page Adyen hosts, so there's nothing to build or embed.

How long does an Adyen payment link stay valid?

24 hours by default. You can extend it up to 70 days from when it was created, in the form's service date or with expiresAt on the API. Five failed payment attempts expire a link early.

Can one Adyen payment link take more than one payment?

Only if you make it reusable. Links are single use by default and show a "You have already paid" message after a successful payment. Set the link type to allow multiple payments, or send reusable: true.

Who can connect Adyen Pay by Link to our invoicing or order system?

n-frames builds that link for businesses on Adyen: payment links created straight from each invoice or order, and the webhook handling that marks the right record paid and flags any link that expires unpaid.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.