Kite
API Referencex402

Open a transfer to be paid with x402

POST
/api/x402/pay

Authorization

headerx-kite-signature<token>

Base64url Ed25519 signature of timestamp nonce METHOD path?query sha256(body), sent with x-kite-api-key-id, x-kite-timestamp and x-kite-nonce

Request Body

application/json
  1. body
quoteId*string
Formatuuid

Response Body

Response for status 201

application/json
  1. response
id*string
Formatuuid
appId*string
Formatuuid
quoteId*string
Formatuuid
settlementRecipient*string
Match^0x[0-9a-fA-F]{40}$
minAmountOut*string
Match^[0-9]+$
Lengthlength <= 78
refundAddress*string
Match^0x[0-9a-fA-F]{40}$
payinAddress*string
Match^0x[0-9a-fA-F]{40}$
kiteTransferInput*
status*string
Value in"Created""AwaitingDeposit""DepositReceived""Processing""x402Settled""Cancelled""Refunded""Failed""Settled"
settlementBlockchainHash*string|null
refundBlockchainHash*string|null
x402Payer*string|null
x402AuthorizationNonce*string|null
x402AuthorizationHash*string|null
x402SettlementCallId*string|null
x402BlockchainHash*string|null
x402LeaseExpiresAt*|
Formatdate-time
x402SettledAt*|
Formatdate-time
x402Offer*boolean
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
paymentInstructions*
Example Request
curl -X POST 'https://testnet.usekite.site/api/x402/pay' \  -H 'Content-Type: application/json' \  -d '{  "quoteId": "826e5192-f8c6-4e24-aab3-3910e46c52b7"}'
Example Response201
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "appId": "28c365d5-df94-4a54-8217-3ce51d068868",  "quoteId": "826e5192-f8c6-4e24-aab3-3910e46c52b7",  "settlementRecipient": "string",  "minAmountOut": "string",  "refundAddress": "string",  "payinAddress": "string",  "kiteTransferInput": {    "id": "string",    "payInTokenAddress": "string",    "amountIn": "string",    "settlementTokenAddress": "string",    "settlementRecipient": "string",    "minAmountOut": "string",    "fees": [      {        "id": "string",        "recipient": "string",        "amount": "string"      }    ],    "refundAddress": "string",    "expiresAt": "string",    "routerAddress": "string",    "poolFeeTier": 0  },  "status": "Created",  "settlementBlockchainHash": "string",  "refundBlockchainHash": "string",  "x402Payer": "string",  "x402AuthorizationNonce": "string",  "x402AuthorizationHash": "string",  "x402SettlementCallId": "string",  "x402BlockchainHash": "string",  "x402LeaseExpiresAt": "2019-08-24T14:15:22Z",  "x402SettledAt": "2019-08-24T14:15:22Z",  "x402Offer": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "paymentInstructions": {    "caip2Id": "string",    "address": "string",    "tokenAddress": "string",    "amount": "string",    "expiresAt": "2019-08-24T14:15:22Z"  }}