---
updatedAt: 2026-07-30T14:20:30.000Z
---

Fetch the complete documentation index at: https://docs.skyfire.xyz/llms.txt. Use this file to discover all available pages before exploring further.

# PAY Token

The payment-related claims carried in `pay` and `kya-pay` tokens.

The following payment-related claims are defined for `pay` and `kya-pay` tokens.

| **Claim** | **Description**                                                                                                                                                                                                                   |
| :-------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `val`     | JSON string representing token amount in settlement network's units.                                                                                                                                                              |
| `amt`     | JSON string representing token amount in currency units.                                                                                                                                                                          |
| `cur`     | Currency unit, represented as an ISO 4217 three letter code, such as "EUR".                                                                                                                                                       |
| `stp`     | Settlement type (one of `coin`, `card`, `bank`). Additional values may be defined and used.                                                                                                                                       |
| `sti`     | Meta information for payment settlement, depending on settlement type.                                                                                                                                                            |
| `spr`     | *OPTIONAL* - JSON string representing seller service price in currency units.                                                                                                                                                     |
| `sps`     | *OPTIONAL* - Seller pricing scheme, which represents a way for the seller list how it charges for its service or content. One of pay\_per\_use, subscription, pay\_per\_mb, or custom. Additional values may be defined and used. |
| `mnr`     | *OPTIONAL* - JSON number representing maximum number of requests when `sps` is `pay_per_use`.                                                                                                                                     |

<br />

***

# Settlement Information (`sti`) Sub-Claims

The **Agent Identity** (`sti`) claim is optional. If present, it contains the following sub-claims.

| **Claim**                | **Description**                                                                                                                   |
| :----------------------- | :-------------------------------------------------------------------------------------------------------------------------------- |
| `type`                   | Dependent on `stp`. For `coin` - `usdc`. For `card` - `visa_vic` or `mastercard_scof`. Additional values may be defined and used. |
| `payment_token`          | *OPTIONAL* - String containing Virtual Payment Card Number in ISO/IEC 7812 format. 12-19 characters.                              |
| `token_expiration_month` | *OPTIONAL* - String containing two-digit Expiration Month Number.                                                                 |
| `token_expiration_year`  | *OPTIONAL* - String containing four-digit Expiration Year.                                                                        |
| `token_security_code`    | *OPTIONAL* - String containing 3 or 4 digit CVV code.                                                                             |
| `verifier`               | *OPTIONAL* - URL of the Payment Verifier                                                                                          |
| `verified`               | *OPTIONAL* - Boolean Verification status. True if verified, otherwise false.                                                      |
| `verification_id`        | *OPTIONAL* - Verification identifier. Identifier for the verification performed, such as a GUID.                                  |

Additional sub-claims MAY be defined and used. The recipient MUST ignore any unrecognized sub-claims.