KeelsonDocs
    Judge Mode

    API reference Merchants

    Choose how a merchant is paid when a dispute goes its way

    PUT/v1/merchants/{merchantId}/settlement

    Applies to verdicts signed afterwards: the rail decides the payee the TEE legs sign into the Verdict. The merchant signs the choice, as it signs its on-chain payout address. Sent by a client with merchants:write or by the merchant's own session.

    Path parameters

    merchantIdstringRequired

    Headers

    Content-Typeapplication/jsonRequired

    Request body

    application/json

    railstringRequired
    pyusd: slashes and warranties pay the merchant in PYUSD on chain. paypal: they pay Keelson's treasury, and Keelson sends the merchant a PayPal Payout in USD.One of pyusdpaypal
    paypal_receiverone of
    The PayPal account paid: an email address or a PayPal account id.
    noncestringRequired
    Higher than the nonce of the merchant's last choice.
    deadlinestringRequired
    Unix seconds after which the signature is refused.
    merchant_signaturestringRequired
    The merchant's EIP-712 SettlementPreference(string merchantId,string rail,string paypalReceiver,uint256 nonce,uint256 deadline) under the bond vault's domain, by its settlement address; paypalReceiver is empty for pyusd.

    Responses

    • 200Stored
    • 403The signature, or the session, is not the merchant's
    • 404No such merchant
    • 409The nonce is not higher than the one of the merchant's last choice

    200 response

    railstringRequired
    pyusd: slashes and warranties pay the merchant in PYUSD on chain. paypal: they pay Keelson's treasury, and Keelson sends the merchant a PayPal Payout in USD.One of pyusdpaypal
    paypal_receiverone of
    The PayPal account paid: an email address or a PayPal account id.