Charge Token

Charge a pay or kya-pay token as a seller agent or seller service.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Use this API after delivering a service, tool, or resource to collect payment from a buyer-issued token.

Before charging, seller services should validate tokens when requests are received and reject tokens that have already expired.

Token Requirements

Only pay and kya-pay tokens can be charged. kya tokens cannot be charged.

Charging After Expiration

To support long-running operations, Skyfire allows charges to be submitted for up to 24 hours after a token expires.

This grace period applies only when the token was accepted and validated before expiration. Seller services should not accept expired tokens from buyers, but may complete charges after expiration for services that began while the token was still valid.

For more information on pay token validation, see here.

Settlement

Charges are not settled immediately. Settlement may take up to 51 hours depending on token expiration and charging activity. For details, see Settlement of Payments.

Body Params
string
required

The complete, signed JWT string received from the buyer agent.

string

The amount to charge from the token. Required unless the seller service uses the pay_per_use pricing model, in which case Skyfire automatically charges the configured service price when omitted.
Tokens may be charged multiple times until their balance is exhausted.
When provided, chargeAmount must:

  • Be greater than 0
  • Be less than or equal to the token's original tokenAmount
  • Be less than or equal to the token's remaining balance

A charge that exceeds the remaining balance will fail.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json
text/plain