Create Token

post

https://api.skyfire.xyz/api/v1/tokens

Create a kya / pay / kya-pay token as a buyer agent.

Body Params

type

string

required

One of "kya", "pay", or "kya-pay"

buyerTag

string

Buyer’s internal identifier for the transaction / token

tokenAmount

string

Must include an amount if this is a payor kya-pay token. Must be Greater than 0, Greater than the minimum token amount specified in the seller service (if any), Less than or equal to the balance in your agent’s wallet.

sellerServiceId

string

You can get the seller service ID from the Skyfire marketplace. One of either "sellerServiceId" or "sellerDomainOrUrl" is required.

sellerDomainOrUrl

string

The URL or domain name of the website, webpage or API, that you are going to access. The domain name is the "(second level domain).(top level domain)" e.g. "example.com", or you can provide the entire URL. One of either "sellerServiceId" or "sellerDomainOrUrl" is required.

expiresAt

int64

Seconds since the Unix epoch. Default: 5 minutes when passing "sellerDomainOrUrl" and 24 hours when passing "sellerServiceId". Must be between 10 seconds and 5 minutes / 24 hours (86,400 seconds) depending on whether you pass "sellerDomainOrUrl" or "sellerServiceId".

identityPermissions

array of strings

Default: empty array. Can be specified if this is a kya or kya-pay token. Additional identity fields to include in the token.

identityPermissions

Responses

Language

Credentials

Header

Request

Response

Choose an example:

application/json

200200

401401

402402

422422