x402 settle

POST

/v1/x402/settle

curl --request POST \
  --url https://api.flowpayra.com/v1/x402/settle \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <X-Api-Key>' \
  --header 'X-Nonce: <X-Nonce>' \
  --header 'X-Signature: <X-Signature>' \
  --header 'X-Timestamp: <X-Timestamp>' \
  --data '{ "payment_id": "example", "payment_payload": { "signature": "example", "authorization": { "from": "example", "to": "example", "value": "example", "valid_after": 1, "valid_before": 1, "nonce": "example" } }, "payment_requirements": { "scheme": "exact", "network": "example", "asset": "example", "pay_to": "example", "max_amount_required": "example", "resource": "https://example.com", "nonce": "example", "valid_before": 1, "extra": "example" } }'

Authorizations

• HmacApiKey
• HmacSignature
• HmacTimestamp
• HmacNonce

Parameters

Header Parameters

Idempotency-Key

string

>= 1 characters <= 128 characters

Request Body^required

Media typeapplication/json

object

payment_id

required

string

payment_payload

required

One of:

object

object

signature

required

string

/^0x[0-9a-fA-F]{130}$/

authorization

required

object

from

required

string

to

required

string

value

required

string

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

valid_after

required

integer format: int64

valid_before

required

integer format: int64

nonce

required

string

object

object

transaction

required

string

<= 2048 characters

payment_requirements

required

object

scheme

required

string

Allowed values: exact upto

network

required

string

asset

required

string

pay_to

required

string

max_amount_required

required

string

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

resource

required

string format: uri

nonce

required

string

valid_before

required

integer format: int64

extra

Responses

200

Successful response

Media typeapplication/json

object

success

required

boolean

tx_hash

required

string

payment_id

required

string

Example^generated

{
  "success": true,
  "tx_hash": "example",
  "payment_id": "example"
}

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"
}