Skip to main content

Overview

These endpoints let merchants retrieve and delete saved shipping addresses tied to a customer or wallet.

Authentication

Requires:
  • x-commerce-api-key

Request

Endpoints:
  • GET /api/v1/commerce/merchant/addresses
  • DELETE /api/v1/commerce/merchant/addresses/{addressId}
Lookup rules:
  • Provide customer_id, or
  • Provide wallet_address and wallet_network Optional pagination:
  • limit (max 100)
  • offset
Example (list by customer_id):
Example (list by wallet):
Example (delete):

Response

Representative list response:

Errors

  • 400 missing/invalid customer identification
  • 401 missing/invalid commerce API key
  • 404 address not found (delete)

Examples

Use these endpoints alongside checkout flows: Next: Payment sessions