One-time payments

Settle a payment the buyer funded with a signature

The buyer holds no native currency and has signed the token authorization the checkout showed them. P2Flux sends the transaction and takes the quoted network fee and the gas-service fee out of that same authorization - nothing is fronted on credit, and a transaction that fails moves no money at all.

status of CONFIRMING means it is in flight. Ask /v1/payments/verify about the hash; do NOT call this again, because the buyer's authorization may already be spent.

post/v1/payments/sponsor

Request

  • Base URL: https://api.p2flux.com
  • URL: https://api.p2flux.com/v1/payments/sponsor
  • Auth: none required

Request body

intentstring required
quotestring required

The p2gas1 token from /v1/payments/resolve.

payerstring required

The wallet that signed. Must match the signature; the contract enforces it.

signaturestring required

65-byte token authorization signature.

Response

Submitted or confirming

status'SUBMITTED' | 'CONFIRMING'
tx_hashstring
referencestring
network_fee_unitsstring
fixed_network_fee_unitsstring
buyer_total_unitsstring
block_numberstring
native_gas_spent_weistring

What the transaction actually cost P2Flux, for reconciliation. The buyer paid the quote, not this.

Changes

No recorded changes to this operation across all 1 revision of this API.