Skip to main content
Bind the seller account created during your keyless trial to your Circle account. After you claim, /settle with a Circle API key works for that payTo, and the trial allowance no longer applies.

Prerequisites

Before you begin, ensure that you’ve:
  • Completed the Accept x402 payments quickstart so you have an unclaimed seller account for your payTo
  • Obtained the private key controlling payTo, which will be used to sign the claim proof

Steps

1

Get a Circle API key

Sign up for a Circle account and create an API key in Circle Console.Already have a Circle API key? Skip this step.
2

Build a claim-purpose seller proof

Follow the procedure in Sign a seller proof with purpose: "claim".
3

Bind your seller account

This binds the seller account to your Circle account. After this call succeeds, /settle accepts your Circle API key for the claimed payTo.The body carries your Circle entity ID. The claim proof from Step 2 signs a digest that covers this body, so the entity ID cannot be swapped after signing.
A successful response returns the bound account and the payTo it was claimed against:
Repeating the claim for the same Circle account is idempotent. Attempting to claim an unknown account, an account you do not control, or an account already bound to another Circle account returns HTTP 403 with no additional detail.The seller account, its payTo, and its payment history remain the same.