Shopify Webhooks

Set Up Webhooks for your Shopify orders

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

Prerequisites

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

1. Log in to the Shopify Merchant Dashboard.

2. Retrieve your API Keys.

3. Obtain your Shopify Pay Link ID – This is the ID found at the end of the URL of the Shopify Pay Link.

Set Up The Webhook

Follow the steps here 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