x402 report usage

POST

/v1/x402/{payment_id}/usage

curl --request POST \
  --url https://api.flowpayra.com/v1/x402/example/usage \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --header 'X-Api-Key: <X-Api-Key>' \
  --header 'X-Nonce: <X-Nonce>' \
  --header 'X-Signature: <X-Signature>' \
  --header 'X-Timestamp: <X-Timestamp>' \
  --data '{ "actual_amount": "example", "usage_id": "example", "evidence": {} }'

Authorizations

• HmacApiKey
• HmacSignature
• HmacTimestamp
• HmacNonce

Parameters

Path Parameters

payment_id

required

string

>= 1 characters <= 128 characters

Header Parameters

Idempotency-Key

required

string

>= 1 characters <= 128 characters

Request Body^required

Media typeapplication/json

object

actual_amount

required

string

<= 128 characters /^(0|[1-9][0-9]*)(\.[0-9]+)?$/

usage_id

required

string

>= 1 characters <= 128 characters

evidence

required

object

key

additional properties

any

Example^generated

{
  "actual_amount": "example",
  "usage_id": "example",
  "evidence": {}
}

Responses

200

Successful response

Media typeapplication/json

object

payment_id

required

string

scheme

required

Allowed value: upto

max_raw

required

string

<= 78 characters /^(0|[1-9][0-9]*)$/

actual_raw

required

string

<= 78 characters /^(0|[1-9][0-9]*)$/

usage_id

required

string

Example

{
  "scheme": "upto"
}

400

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

401

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

404

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

409

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

422

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}