导入
商家 API
学习如何使用商家 API 检索关于 Square 商家账户的信息。
Merchants API 用于获取 Square 卖家账户的相关信息。假设我们开发了一个使用 Square 处理支付的应用程序，卖家在创建应用账户时会提供其信息。我们可以使用 Merchants API 获取卖家账户信息，例如公司名称、国家和地区、语言等。
接下来，我们来看看如何通过 Merchants API 获取卖家信息。
获取商家列表
当需要在不知道商家 ID 的情况下获取 Square 商家账户信息时，此端点非常有用。通过访问令牌，我们可以调用此端点来获取所有商家的信息。
注意： 以下代码会返回商家信息，你可以从中提取商家 ID 并保存到
MERCHANT_ID变量中，供后续示例使用。
1from square.client import Client 2from pprint import pprint 3 4client = Client( 5 access_token= '{{ACCESS_TOKEN}}', 6 environment='sandbox' 7) 8 9result = client.merchants.list_merchants() 10 11if result.is_success(): 12 pprint(result.body) 13elif result.is_error(): 14 pprint(result.errors)
注意： 代码第 1 至 7 行在所有代码片段中保持一致，因此后续示例将省略这部分内容。
获取商家详情
通过商家 ID，RetrieveMerchant 端点可获取 Square 商家账户的详细信息。该端点仅需一个参数：merchant_id。如果传入 "me" 字符串作为 ID，则返回当前调用可访问的商家信息。
1result = client.merchants.retrieve_merchant( 2 merchant_id = "{{MERCHANT_ID}}" 3) 4 5if result.is_success(): 6 pprint(result.body) 7elif result.is_error(): 8 pprint(result.errors)