Skip to main content
POST
Claim a Facilitator Service seller account

Authorizations

Authorization
string
header
required

Bearer token authentication with a Circle API key. Use this for production settlement after claiming your Facilitator Service seller account.

Facilitator-Seller-Proof
string
header
required

Base64url-encoded envelope carrying an EIP-712 signature that proves the caller controls the payTo address. Use this for the keyless trial before claiming your Facilitator Service seller account.

Body

application/json
entityId
string<uuid>
required

The Circle entity ID to which the seller account is bound.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Response

Claim result

status
enum<string>
required

Ownership state of the seller account.

Available options:
claimed
Example:

"claimed"

payTo
string
required

The seller account's payTo address.

Example:

"0x7c3eA945Fc4253255D8260fC18C2deE3D8c5DD3a"

entityId
string<uuid>
required

Circle entity ID the account is bound to.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"