Pay with Link

Type: E-wallet / Digital Payment Service

Payment Flow:

The customer selects Link at checkout.

A Link payment modal opens.

The customer signs in to Link.

Link authorizes the payment.

UseePay returns the PaymentIntent result to the merchant.

Refunds: Supports full and partial refunds after the payment has been captured.

Notes:

Suitable for online and cross-border payment scenarios.

Link is currently unavailable in India.

Subscription payments are not currently supported.

Link supports both automatic capture and authorization followed by manual capture.

Supported Transaction Types

Product Support

Supported Countries

One-time payment with automatic capture

Authorization followed by manual capture

Integration Guide

Link supports two transaction modes:

Mode	`auto_capture`	Status after successful processing	Merchant action
Automatic capture	`true`	`succeeded`	No capture request is required
Authorization and capture	`false`	`requires_capture`	Capture or cancel the PaymentIntent

Always set auto_capture explicitly. Do not rely on its default value.

Shipping information

When using Link through Express Checkout, we recommend that you do not provide shipping when creating the PaymentIntent because Link can collect the customer's shipping information.

If shipping is provided when confirming the PaymentIntent, the merchant-provided shipping information overrides the information collected by Link.

For Link payments, billing_country must be provided where required by the PaymentMethod request.

One-time Link payment

For a normal Link payment, create the PaymentIntent with automatic capture enabled:

{
  "amount": 100.00,
  "currency": "USD",
  "merchant_order_id": "ORDER_20260922001",
  "payment_method_types": [
    "link"
  ],
  "auto_capture": true
}

After the customer completes the Link flow, the PaymentIntent normally reaches succeeded.

The merchant should verify the PaymentIntent status or process the corresponding webhook before fulfilling the order.

Link authorization and capture

Link authorization separates the authorization of funds from the actual capture.

Create the PaymentIntent with auto_capture set to false:

{
  "amount": 100.00,
  "currency": "USD",
  "merchant_order_id": "ORDER_20260922002",
  "payment_method_types": [
    "link"
  ],
  "auto_capture": false
}

The authorization flow is:

Create PaymentIntent
        ↓
Customer completes the Link flow
        ↓
requires_customer_action / pending
        ↓
requires_capture
        ├── Capture → succeeded
        └── Cancel  → canceled

A PaymentIntent in requires_capture status has been successfully authorized, but the funds have not yet been captured.

Do not treat requires_capture as a completed payment or fulfill the order before the capture succeeds.

Capture the authorization

When the PaymentIntent reaches requires_capture, call:

Example request:

{
  "amount": 100.00,
  "merchant_order_id": "ORDER_20260922002",
  "final_capture": true
}

Important considerations:

The PaymentIntent must be in requires_capture.

The capture amount must equal the full authorized amount.

Partial capture is not supported.

Multiple captures are not supported.

Only one full capture can be performed for each PaymentIntent.

final_capture must be set to true.

After a successful capture, the PaymentIntent reaches succeeded.

After capture succeeds, any subsequent adjustment must be processed through the Refund API.

See Capture a PaymentIntent.

Cancel the authorization

If the authorization is no longer required, cancel the PaymentIntent before it is captured:

Example request:

{
  "cancellation_reason": "request_by_customer"
}

Canceling an authorization is different from issuing a refund:

Use Cancel before capture to release the authorization.

Use Refund after the payment has been captured.

A PaymentIntent that has already been captured cannot be canceled.

The time required for the authorized amount to become available again depends on Link and the customer's financial institution.

See Cancel a PaymentIntent.

Link authorization compared with card authorization

Item	Link authorization	Card authorization
Payment method	Link account and eligible funding source	Credit or debit card
Customer interaction	Completed in the Link modal	Card entry and possible 3DS authentication
Authorization setting	`auto_capture=false`	`auto_capture=false`
Successful authorization status	`requires_capture`	`requires_capture`
Capture operation	One full capture	Depends on the card capability enabled for the merchant
Capture API	PaymentIntent Capture API	PaymentIntent Capture API
Cancel API	PaymentIntent Cancel API	PaymentIntent Cancel API
Shipping information	Can be collected by Link in Express Checkout	Usually supplied by the merchant
Subscription support	Not currently supported	Depends on card and merchant capabilities

Although Link authorization and card authorization use the same PaymentIntent lifecycle, they differ in customer interaction, payment credentials, supported regions, and risk controls.

PaymentIntent status handling

Status	Description	Merchant action
`requires_payment_method`	A payment method is required	Wait for the customer to select Link
`requires_customer_action`	The customer must complete an action in Link	Display or continue the Link flow
`pending`	The payment result is still being processed	Wait for a webhook or retrieve the PaymentIntent
`requires_capture`	The authorization succeeded	Capture or cancel the authorization
`succeeded`	The full amount was captured successfully	Fulfill the order
`canceled`	The PaymentIntent was canceled	Close or restore the order
`failed`	The authorization or payment failed	Display the failure and allow retry where applicable

Do not determine the final payment result only from the browser redirect. Use the PaymentIntent status and webhook events as the source of truth.

Relevant webhook events include:

payment_intent.requires_customer_action
payment_intent.pending
payment_intent.requires_capture
capture.succeeded
capture.failed
payment_intent.cancelled
payment_intent.failed

Webhook processing should be idempotent because events might be delivered more than once or arrive out of order.

Use Link in checkout

Wait for the Link button to appear on the checkout page.

Click the Link button and enter the email address associated with the Link account.

Select a shipping address and an eligible funding source.

Complete the Link payment or authorization.

After the Link flow finishes, the customer is redirected back to the checkout page.

Check the PaymentIntent status:

If the status is succeeded, the payment is complete.

If the status is requires_capture, submit a full capture request when the order is ready.

If the status is pending, wait for the final webhook notification.

If the status is failed or canceled, do not fulfill the order.

Integration checklist

Before going live, make sure that:

auto_capture is explicitly set for every Link PaymentIntent.

The merchant system correctly handles requires_customer_action.

The merchant system does not treat requires_capture as a completed payment.

Only one full capture is submitted for each authorized PaymentIntent.

The capture amount equals the authorized amount.

Authorizations that are no longer required are canceled.

Captured payments are adjusted through the Refund API instead of the Cancel API.

PaymentIntent and Capture webhook events are verified and processed idempotently.

Order fulfillment is based on the final PaymentIntent status rather than the browser redirect.

Integration Guide#

Shipping information#

One-time Link payment#

Link authorization and capture#

Capture the authorization#

Cancel the authorization#

Link authorization compared with card authorization#

PaymentIntent status handling#

Use Link in checkout#

Integration checklist#