{
"id": "123e4567-e89b-12d3-a456-426614174000",
"subscription_id": "123e4567-e89b-12d3-a456-426614174000",
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"membership_id": "123e4567-e89b-12d3-a456-426614174000",
"type": "v1/payment-links",
"created_at": "2025-01-24T10:55:00Z",
"data": {
"event": "created",
"status": "open",
"payment_link_id": "0199e1de-4fa1-7324-9aed-0b0f6a65243e",
"amount": {
"currency": "EUR",
"value": "77052.50"
},
"potential_payment_methods": [
"bank_transfer",
"credit_card",
"apple_pay",
"paypal"
],
"resource_id": "0199e1de-4e01-72b7-86a0-fbe4e0475d56",
"resource_metadata": {
"invoice_number": "H2025-343"
},
"resource_type": "Invoice",
"expired_at": "2026-10-14T08:37:47Z",
"created_at": "2025-10-14T08:37:47Z",
"updated_at": "2025-10-14T08:37:47Z"
}
}
Supported webhooks
v1/payment-links
OAuth scope: payment_link.read
Webhook that delivers events related to payment links.
Supported events:
payment_links.createdpayment_links.updated
WEBHOOK
v1
/
payment-links
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"subscription_id": "123e4567-e89b-12d3-a456-426614174000",
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"membership_id": "123e4567-e89b-12d3-a456-426614174000",
"type": "v1/payment-links",
"created_at": "2025-01-24T10:55:00Z",
"data": {
"event": "created",
"status": "open",
"payment_link_id": "0199e1de-4fa1-7324-9aed-0b0f6a65243e",
"amount": {
"currency": "EUR",
"value": "77052.50"
},
"potential_payment_methods": [
"bank_transfer",
"credit_card",
"apple_pay",
"paypal"
],
"resource_id": "0199e1de-4e01-72b7-86a0-fbe4e0475d56",
"resource_metadata": {
"invoice_number": "H2025-343"
},
"resource_type": "Invoice",
"expired_at": "2026-10-14T08:37:47Z",
"created_at": "2025-10-14T08:37:47Z",
"updated_at": "2025-10-14T08:37:47Z"
}
}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"subscription_id": "123e4567-e89b-12d3-a456-426614174000",
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"membership_id": "123e4567-e89b-12d3-a456-426614174000",
"type": "v1/payment-links",
"created_at": "2025-01-24T10:55:00Z",
"data": {
"event": "created",
"status": "open",
"payment_link_id": "0199e1de-4fa1-7324-9aed-0b0f6a65243e",
"amount": {
"currency": "EUR",
"value": "77052.50"
},
"potential_payment_methods": [
"bank_transfer",
"credit_card",
"apple_pay",
"paypal"
],
"resource_id": "0199e1de-4e01-72b7-86a0-fbe4e0475d56",
"resource_metadata": {
"invoice_number": "H2025-343"
},
"resource_type": "Invoice",
"expired_at": "2026-10-14T08:37:47Z",
"created_at": "2025-10-14T08:37:47Z",
"updated_at": "2025-10-14T08:37:47Z"
}
}
Authorizations
The signature header follows the format t={timestamp},v1={signature}.
Verification steps:
- Extract the timestamp and signature from the signature header
- Reject the request if the timestamp is older than 5 minutes
- Recreate the signed payload: '{timestamp}.{raw_request_body}'
- Compute HMAC-SHA256 of the signed payload using your webhook secret as the key
- Compare the computed signature with the one in the header
Body
application/json
Unique identifier for this webhook event
Example:
"123e4567-e89b-12d3-a456-426614174000"
ID of the webhook subscription that received the event
Example:
"123e4567-e89b-12d3-a456-426614174000"
ID of the organization that owns the bank account
Example:
"123e4567-e89b-12d3-a456-426614174000"
ID of the membership associated with subscription
Example:
"123e4567-e89b-12d3-a456-426614174000"
Available options:
v1/transactions, v1/accounts, v1/organizations, v1/memberships, v1/consent-revocations, v1/cards, v1/payment-links, v1/payment-links-connections, v1/beneficiaries, v1/client-invoices, v1/terminal-payments, v1/clients, v1/products, v1/transfers, v1/recurring-transfers Example:
"v1/transactions"
Timestamp when the webhook event was created
Example:
"2025-01-24T10:55:00Z"
Show child attributes
Show child attributes
Response
200
Webhook received successfully
Was this page helpful?