payTo) on your first
/settle call and keeps
settling payments until you hit the trial limit.
Seller proof
With no API key to authenticate keyless requests, Facilitator Service relies on a seller proof: an EIP-712 signature from the key controllingpayTo. The proof
shows Facilitator Service that you own the payTo address.
See Sign a seller proof for how to
construct one.
The trial allowance
EachpayTo has its own trial allowance on each supported blockchain, with
testnet and mainnet counted separately. Each
/settle call counts
against that allowance. Once it’s exhausted, /settle responds with
HTTP 403 registration_required. To continue settling, authenticate with a
Circle API key.
Facilitator Service seller accounts
A seller account is the record Facilitator Service keeps for apayTo. It
tracks payment history and, during the keyless trial, how much of the trial
allowance you’ve consumed. Facilitator Service creates one automatically the
first time you settle a payment for a new payTo.
A new seller account has no Circle account attached. Settle once for that
payTo with a Circle API key, and Facilitator Service binds the account to
yours. There is no separate registration step. The trial allowance stops
applying. Payment history carries over.
If you don’t have a Circle account yet, create one in
Circle Console and generate an
API key.