You can set up webhooks to receive notification alerts and data regarding payments made on your Shopify store via Solana Pay.

Pre-requisites

Before setting up the webhook, ensure you do the following:

Log in to the Shopify Merchant Dashboard.
Retrieve your API Keys.
Obtain your Shopify Pay Link ID – This is the ID found at the end of the URL of the Shopify Pay Link.

Setting Up the Webhook

First use our API to configure the webhook for receiving payment notifications.

Shopify Payment Webhook Payload

Upon successful payment, you will receive the following payload:

"event": "CREATED",
  "transactionObject": {
    "id": "67d0163484e9de99088b8c05",
    "paylinkId": "66b3ae45d561f776b94873f0",
    "fee": "200",
    "quantity": 1,
    "createdAt": "2025-03-11T10:53:40.016Z",
    "paymentType": "PAYLINK",
    "meta": {
      "id": "67d0163484e9de99088b8c03",
      "amount": "19800",
      "senderPK": "89ZFMYrbVFA8vwuw1wzPHQBHYCJsPuMpE9izfcKeb5Qp",
      "recipientPK": "Bd1EQQasAcpudCWYXZVL2tSjktJkCJVqPU2Nd6VNrEEV",
      "transactionType": "PAYLINK",
      "customerDetails": {},
      "productDetails": null,
      "additionalProductDetails": [],
      "transactionSignature": "3RXXiJxRjVE3ypdEzWvcNW2ASb3gc1C4Vc4U2KJJwcrzPjKtM5yep1Gmz4vDhutf229m3ApZtb9sgrMhLYMYDQYr",
      "transactionStatus": "SUCCESS",
      "splitRevenue": false,
      "remainingAccounts": [],
      "totalAmount": "19800",
      "affiliateAmount": "0",
      "tokenQuote": {
        "from": "USDC",
        "fromAmountDecimal": "0.02",
        "to": "USDC",
        "toAmountMinimal": "20000"
      },
      "shopifyPaymentDetails": {
        "shopifyPaymentGid": "gid://shopify/PaymentSession/rVVb9k5vukGQollX60oEUQi0L",
        "shopifyPaymentId": "rVVb9k5vukGQollX60oEUQi0L"
      },
      "submitGeolocation": "GB",
      "currency": {
        "id": "6340313846e4f91b8abc519b",
        "blockchain": null
      }
    }
  }
}

In the payload above, the shopifyPaymentDetails object contains the following identifiers, which are useful for referencing payments made on your Shopify store:

shopifyPaymentGid - A global unique identifier
shopifyPaymentId - A reference ID for the payment