The Charge Token API allows sellers to charge a previously issued pay or kya-pay token after delivering a service, tool, or resource.
Token Requirements
Only tokens with the following typ values can be charged:
paykya-pay
Tokens of type kya cannot be charged.
Token Expiration Handling
Sellers are expected to enforce the token's exp claim and reject tokens that have expired.
However, Skyfire allows a token to be charged up to 24 hours after its expiration time.
This allows sellers to complete payment processing for services that may take time to deliver.
Expired Token Charging Window
If a token is charged after its expiration but within the 24-hour grace period, Skyfire assumes that:
- The seller validated the token before it expired, and
- The charge corresponds to a service that was accepted while the token was still valid.
That is, sellers should not accept already-expired tokens from buyers, but they may complete a charge shortly after expiration if the service execution began while the token was valid.
Best Practices
Sellers should:
- Validate the token when the request is first received
- Reject tokens that are already expired
- Only charge tokens associated with a valid service request
This ensures proper accounting ant prevents misuse of expired tokens.