# The Shared Payment Granted Token object

### The Shared Payment Granted Token object

```json
{
  "id": "spt_1RgaZcFPC5QUO6ZCDVZuVA8q",
  "object": "shared_payment.granted_token",
  "agent_details": {
    "network_business_profile": "profile_test_61U92KWAstyE3VYhXA6U91t01FSQ3ByrZzKJOCR0y5ey"
  },
  "created": 1751500820,
  "deactivated_at": null,
  "deactivated_reason": null,
  "livemode": false,
  "payment_method_details": {
    "type": "card",
    "billing_details": {
      "address": {
        "city": null,
        "country": null,
        "line1": null,
        "line2": null,
        "postal_code": null,
        "state": null
      },
      "email": null,
      "name": "John Doe",
      "phone": null
    },
    "card": {
      "brand": "visa",
      "country": "US",
      "display_brand": "visa",
      "exp_month": 9,
      "exp_year": 2029,
      "fingerprint": "dyRcYjZNxnHpC51l",
      "funding": "credit",
      "last4": "4242",
      "networks": {
        "available": [
          "visa"
        ],
        "preferred": null
      },
      "wallet": null
    }
  },
  "shared_metadata": {},
  "usage_details": {
    "amount_captured": {
      "value": 0,
      "currency": "usd"
    }
  },
  "usage_limits": {
    "currency": "usd",
    "expires_at": 1751587220,
    "max_amount": 1000
  }
}
```

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string)
  String representing the object’s type. Objects of the same type share the same value.

- [`agent_details`](https://docs.stripe.com/api/shared-payment/granted-token/object.md?query=agent_details) (object, nullable)
  Details about the agent that issued this SharedPaymentGrantedToken.

- `created` (timestamp)
  Time at which the object was created. Measured in seconds since the Unix epoch.

- `deactivated_at` (timestamp, nullable)
  Time at which this SharedPaymentGrantedToken expires and can no longer be used to confirm a PaymentIntent.

- `deactivated_reason` (enum, nullable)
  The reason why the SharedPaymentGrantedToken has been deactivated.
Possible enum values:
  - `consumed`
    `consumed` indicates that this token has been consumed due to hitting the allowed amount limit.

  - `expired`
    `expired` indicates that this token has expired.

  - `resolved`
    `resolved` indicates that this token has been resolved by a seller.

  - `revoked`
    `revoked` indicates that this token has been revoked by the issuer.

- `livemode` (boolean)
  If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.

- [`payment_method_details`](https://docs.stripe.com/api/shared-payment/granted-token/object.md?query=payment_method_details) (object, nullable)
  Details of the PaymentMethod that was shared via this token.

- [`risk_details`](https://docs.stripe.com/api/shared-payment/granted-token/object.md?query=risk_details) (object, nullable)
  Risk details of the SharedPaymentGrantedToken.

- `shared_metadata` (map, nullable)
  Metadata about the SharedPaymentGrantedToken.

- [`usage_details`](https://docs.stripe.com/api/shared-payment/granted-token/object.md?query=usage_details) (object, nullable)
  Some details about how the SharedPaymentGrantedToken has been used already.

- [`usage_limits`](https://docs.stripe.com/api/shared-payment/granted-token/object.md?query=usage_limits) (object, nullable)
  Limits on how this SharedPaymentGrantedToken can be used.
