Skip to main content
This page covers every configuration option available when creating a PIK Payment Link.

​
Required fields

amount_type — Set to fixed for a specific amount, or open for a payer-entered amount. currency — The currency the payer must send. Supported: USDT, USDC, AUD. reference — A unique identifier string for your records and for the payer to use as their transfer reference. Keep it short and without spaces, for example INV-2025-001.

​
Optional fields

amount — Required when amount_type is fixed. The exact decimal amount, for example 150.00. expiry — ISO 8601 datetime when the link deactivates. single_use — Boolean. True for single-use, false for reusable. Defaults to false. merchant_name — Your business name as displayed on the payment page. merchant_logo_url — URL to your logo image. Recommended 200x200px PNG or SVG. redirect_url — URL the payer is redirected to after successful payment. webhook_url — URL for payment event notifications for this specific link, overriding your account-level webhook setting. metadata — Key-value object for attaching your own internal data. Returned in API responses and webhooks but not visible to the payer. PIK returns two shareable assets after creation: payment_url — The full URL to the payment page. qr_code_url — A URL to a QR code image encoding the payment URL.

​
Editing and cancelling

Payment Links cannot be edited after creation. Cancel via DELETE /api/v1/payment-links/payment_link_id or from the PIK Dashboard under Payments > Payment Links.