Sign in
payment

Build an unsigned x402 funds-locking transaction for a payment. (+READ access required)

Builds an unsigned Cardano funds-locking transaction for an existing payment request. The seller calls this on behalf of the buyer (x402 protocol). No state is saved — the returned CBOR must be signed by the buyer and submitted to the network.

post/payment/x402

Request

  • Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
  • URL: ./../api/v1/payment/x402
  • Auth: API key in header token

Request body

network'Preprod' | 'Mainnet' required

The Cardano network

blockchainIdentifierstring required

The blockchainIdentifier from the PaymentRequest

buyerAddressstring required

The buyer's bech32 Cardano wallet address. UTxOs fetched from this address to build the unsigned tx.

Example request

{
  "network": "Preprod",
  "blockchainIdentifier": "blockchain_identifier",
  "buyerAddress": "addr_test1qp..."
}

Response

Unsigned transaction CBOR ready for buyer to sign and submit

statusstring required

Example response

{
  "status": "Success",
  "data": {
    "unsignedTxCbor": "84a500818258...",
    "collateralReturnLovelace": "1500000"
  }
}

Changes