Flash ProtocolFLASH PROTOCOL
DOCUMENTATION

Merchant

Retrieve and update your merchant profile.

Get Merchant Profile

Retrieve your merchant profile including default receive settings and stealth privacy status.

GET/api/v1/merchant
curl -X GET https://flash-protocol.vercel.app/api/v1/merchant \
  -H "Authorization: Bearer pg_live_..."
200 OK
{
  "wallet_address": "0x1234...abcd",
  "business_name": "Acme Inc",
  "email": "billing@acme.com",
  "default_receive_chain": "8453",
  "default_receive_token": "USDC",
  "stealth_enabled": false,
  "created_at": "2024-03-15T12:00:00Z"
}

Update Merchant Profile

Update your default receive settings and profile information. All fields are optional — only include the fields you want to change.

PUT/api/v1/merchant

Request Body

Field
Type
Required
Description
default_receive_chain
string | number | null
No
Default chain ID for receiving payments.
default_receive_token
string | null
No
Default token address for receiving payments.
business_name
string | null
No
Business display name (max 255 chars).
email
string | null
No
Contact email address.
curl -X PUT https://flash-protocol.vercel.app/api/v1/merchant \
  -H "Authorization: Bearer pg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "default_receive_chain": "8453",
    "default_receive_token": "USDC",
    "business_name": "Acme Inc"
  }'
200 OK
{
  "wallet_address": "0x1234...abcd",
  "business_name": "Acme Inc",
  "email": "billing@acme.com",
  "default_receive_chain": "8453",
  "default_receive_token": "USDC",
  "stealth_enabled": false,
  "created_at": "2024-03-15T12:00:00Z"
}

Error Responses

Status
Code
Description
400
Validation Error
Invalid field values or no fields provided.
401
Unauthorized
Invalid or missing API key.
404
Not Found
Merchant profile not found.