SX Digital Pay
  1. Webhooks
SX Digital Pay
  • Getting started
  • Authentication
  • Webhook Validation
  • Webhook Delivery System
  • Recommended workflows
  • Merchant
    • Get merchant profile
      GET
  • PaymentLinks
    • Create single-use payment link
      POST
    • List single-use payment links
      GET
    • Get link details
      GET
  • Webhooks
    • Link created
    • Link status changed
    • Link paymentStatus changed
  1. Webhooks

Link created

Webhook
POST
payment_link.created
Sent when an external link is created and webhookUrl is set.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "5e3d2c6a-1d40-4a54-9e1c-1a2b3c4d5e6f",
    "type": "payment_link.created",
    "createdAt": "2024-12-05T18:31:00.000Z",
    "data": {
        "id": "01KDKKYMM61YP04ZE9M6YM95TG",
        "title": "Payment Title",
        "description": "Payment Description",
        "externalReference": "4ebd0208-8328-5d69-8c44-ec50939c0967",
        "status": "ACTIVE",
        "previousStatus": null,
        "isMultiUse": false,
        "amount": 129.9,
        "currency": "USD",
        "url": "https://app.sxdigitalpay.com/quote/[merchantShortName]/[paymentLinkId]",
        "shortUrl": "https://sxpay.me/[paymentLinkShortId]",
        "metadata": null
    }
}'
Response Response Example
{}
Previous
Get link details
Next
Link status changed
Built with