Apple Pay on Payment Links

VINR Payment Links support Apple Pay with no additional configuration. When a customer opens a Payment Link in Safari on an eligible device with an active Wallet card, the Apple Pay button appears above the card form automatically.

Payment Links are best for selling a small number of products or collecting one-time or recurring payments without building a custom checkout page. For more dynamic needs (real-time shipping recalculation, coupon codes, custom line items), use Hosted Checkout.

Create a Payment Link with Apple PayAskCopy

Apple Pay is enabled by default on all Payment Links. Create a link in the Dashboard or via the API:

curl https://api.vinr.com/v1/payment_links \
  -u YOUR_SECRET_KEY: \
  -d "line_items[0][price]=price_123" \
  -d "line_items[0][quantity]=1"

Share the returned url with customers. No domain registration is required — VINR's domain is already registered with Apple.

Collect shipping address and contactAskCopy

Enable shipping collection when creating the link:

curl https://api.vinr.com/v1/payment_links \
  -u YOUR_SECRET_KEY: \
  -d "line_items[0][price]=price_123" \
  -d "line_items[0][quantity]=1" \
  -d "shipping_address_collection[allowed_countries][]=US" \
  -d "shipping_address_collection[allowed_countries][]=GB" \
  -d "phone_number_collection[enabled]=true"

On eligible devices, the Apple Pay sheet will prompt the customer to select a shipping address from their Wallet profile. The address is returned in the checkout.session.completed webhook under shipping_details.

Subscription Payment LinksAskCopy

Set mode=subscription to create a recurring Payment Link. VINR automatically requests an MPAN when the customer pays with Apple Pay, enabling future merchant-initiated charges without re-prompting.

curl https://api.vinr.com/v1/payment_links \
  -u YOUR_SECRET_KEY: \
  -d "line_items[0][price]=price_monthly_plan" \
  -d "line_items[0][quantity]=1" \
  -d "mode=subscription"

See Merchant tokens for MPAN lifecycle details.

Limitations compared to Hosted CheckoutAskCopy

If you need any of the features in the right column, use Hosted Checkout instead.

Test Apple Pay on Payment LinksAskCopy

1. Create a Payment Link using your test secret key.
2. Open the link in Safari on an iPhone or Mac.
3. Complete the payment with Face ID, Touch ID, or passcode — no real charge is made in test mode.
4. Verify the checkout.session.completed webhook arrives with payment_status: "paid".

See alsoAskCopy