> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pay Link Payload Reference

> JSON payload reference for Pay Link transaction webhook events

JSON bodies delivered for Pay Link webhook events. For events, scope, and setup, see [Pay Link webhooks](/reference/webhook/paylink-transaction/overview). See [Webhook request headers](/reference/webhook/overview#webhook-request-headers) for delivery headers.

## CREATED

```json JSON theme={null}
{
  "event": "CREATED",
  "chargeToken": "7e75a4fb-32fd-4aa9-b787-b4ca04289932",
  "affiliateLink": "somecode",
  "transaction": "...",
  "transactionObject": {
    "id": "65e1df4d0ce08148bc333b62",
    "paylinkId": "65dc9f9f1154beaac39976c8",
    "fee": "1000",
    "quantity": 1,
    "createdAt": "2024-03-01T13:59:41.303Z",
    "paymentType": "PAYLINK",
    "meta": {
      "id": "65e1df4d0ce08148bc333b60",
      "amount": "9900000",
      "senderPK": "Er3RwfYqCETBTf5RktezXaNDT3zYgwBMftxBYbX8Zk1G",
      "recipientPK": "Er3RwfYqCETBTf5RktezXaNDT3zYgwBMftxBYbX8Zk1G",
      "customerDetails": {
        "country": "United States",
        "deliveryAddress": "test-address",
        "email": "test@example.com",
        "fullName": "test-full-name",
        "phoneNumber": "+0123123123123",
        "discordUsername": "a11111118100",
        "discordUser": {
          "id": "1234567890",
          "username": "test-discord-username"
        },
        "twitterUsername": "test-x-username",
        "telegramUser": null,
        "state": "test-state",
        "street": "test-street",
        "streetNumber": "123",
        "areaCode": "90210",
        "city": "test-city",
        "additionalJSON": "\"{\\\"test\\\": 123}\""
      },
      "productDetails": null,
      "additionalProductDetails": [],
      "transactionSignature": "5AYzruixQiGX8rm279cPLo7bdqaUPYMD8Z3QnBNVz2omZHaUsUKFZRmaV8W7sAHPEyExeHkjquy8mg6LHcNktg5c",
      "transactionStatus": "SUCCESS",
      "splitRevenue": false,
      "remainingAccounts": [],
      "totalAmount": "9900000",
      "affiliateAmount": "0",
      "affiliateCode": "somecode",
      "affiliatePublicKey": "Er3RwfYqCETBTf5RktezXaNDT3zYgwBMftxBYbX8Zk1G",
      "tokenQuote": {
        "from": "SOL",
        "fromAmountDecimal": "0.01",
        "to": "SOL",
        "toAmountMinimal": "10000000"
      },
      "submitGeolocation": "FR",
      "currency": {
        "id": "63430c8348c610068bcdc474",
        "blockchain": {
          "id": "6340313846e4f91b8abc515c",
          "name": "SOL",
          "symbol": "SOL",
          "displayName": "Solana"
        }
      }
    }
  },
  "discountCodes": []
}
```

<Info>
  `transaction` is a JSON string containing the same data as `transactionObject`. `chargeToken` links to the buyer's charge page. `affiliateLink` mirrors `meta.affiliateCode` when an affiliate referred the payment. `discountCodes` is included only when discount codes were applied.
</Info>

For Shopify-specific fields, see [Shopify webhooks](/reference/webhook/shopify).

## Geolocation

The `submitGeolocation` field in `transactionObject.meta` provides the ISO 3166-1 alpha-2 country code for the IP address that submitted the transaction:

```json JSON theme={null}
"submitGeolocation": "FR"
```