Refunds

You can refund charges that have been previously captured. Refunds can be whole or partial.

Issuing a Refund

To refund a payment, you need the payment_intent ID or the charge ID.

Request Example

curl https://api.paylinker.com/v1/refunds \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d payment_intent=pi_1F7XJPCjWp3Z

Partial Refunds

You can refund a specific amount by providing the amount parameter.

curl https://api.paylinker.com/v1/refunds \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d payment_intent=pi_1F7XJPCjWp3Z \
  -d amount=1000

Note: The amount is in the smallest currency unit (e.g., cents).

Refund Timelines

Processing Time

Refunds usually take 5-10 business days to appear on your customer's statement. This depends on the customer's bank.

• Credit Cards: 5-10 business days.
• Paylinker Balance: Instant.

Disputes and Refunds

Important: Disputes vs Refunds

If a customer disputes a charge (chargeback) before you issue a refund, you cannot refund the charge. You must respond to the dispute instead.

If you refund the charge before a dispute is filed, you are protected from the dispute fee.

Webhooks

Listen for refund.created and refund.updated events to track the status of refunds.