使用场景
企业使用 Xegora 的四种方式
四种用法，都在同一个工作区、用同一笔预付余额完成。
订单流程
从一次 API 调用到兑换码送达
礼品卡、eSIM 和话费充值走的都是同一条路：三次调用，外加一个签名 Webhook。
- POST /orders
您的系统
您的应用或后台系统发出要购买的商品，以及您愿意支付的最高价格。
- reserved
Xegora API
我们完成定价，并在您的余额中预留相应金额。如果价格超过您的上限，订单会被拒绝。
- order.fulfilled
订单已交付
礼品卡或 eSIM 签发完成，签名 Webhook 随即通知您的系统。
- POST …/fulfillment
您的客户
您通过经审计的调用获取兑换码，并在自己的应用中展示。
每次查看兑换码都有记录，兑换码从不缓存。阅读开发者指南
您将获得
商户工作区里有什么
礼品卡、eSIM 和话费充值，数量实时更新。
- 礼品卡购物、游戏、餐饮、旅行等等。
- eSIM 流量套餐预付旅行流量，扫 QR 码即可安装。
- 话费充值为手机号充值，下单方式和其他商品一样。
当前规模最大的礼品卡货架
- 餐饮与杂货1,250
- 时尚与服饰1,138
- 旅行与住宿834
- 娱乐与流媒体573
- 健康与美容375
- 游戏330
- 家居生活329
- 移动与通信285
- 运动与户外182
- 科技与电子产品166
礼品卡、eSIM 和话费充值共用一套数据结构和同一个下单接口。只需对接一次，新商品会自动出现。
一次调用完成定价和下单。
const order = await fetch("https://myapi.xegora.com/api/v1/orders", { method: "POST", headers: { "X-Api-Key": process.env.XEGORA_API_KEY!, "Idempotency-Key": "order-10231", // a retry returns the same order "Content-Type": "application/json", }, body: JSON.stringify({ clientReference: "po-10231", item: { productId, variantId, quantity: 1, currency: "USD" }, maximumTotal: 60.0, // never charged above this }),}).then((response) => response.json());// 202 Accepted: order.status is "reserved" until it is fulfilled- 纯 HTTPS 和 JSON，无需 SDK
- 每笔订单都带 Idempotency-Key
- 每个工作区每分钟 120 次请求
余额、订单、报表和团队，集中在一处管理。
- 日常数字礼品卡50 EUR已交付$58.50
- 日常数字礼品卡25 EUR处理中$29.25
- 日常数字礼品卡100 EUR已交付$117.00
- 在目录中手动下单，无需写代码
- 按商品、品牌、类别和国家/地区生成报表
- 六种团队角色，从所有者到查看者
订单每有变化，都会推送一条签名事件。
POST /webhooks/xegora HTTP/1.1Host: your-app.exampleContent-Type: application/jsonX-Xegora-Event-Id: <stable event id>X-Xegora-Signature: <HMAC-SHA256 signature>可订阅的事件
- order.processing
- order.under_review
- order.fulfilled
- order.failed
- order.refunded
- wallet.credited
- 使用 HMAC-SHA256 签名
- 至少送达一次，失败自动重试
- 每条事件都有固定 ID，重复事件轻松去除
在控制台发送测试事件，并查看每一次推送记录。
快速入门
四步完成首单
您需要一个邮箱已验证的 Xegora 账户。
提交申请
在您的 Xegora 账户中提交公司名称、注册号和联系人。
完成审核
工作区开通前，我们的团队会审核每一家企业。结果将通过邮件通知您。
为余额充值
用 USDT或USDC 充值即可激活工作区。如有开通费，会从这笔余额中支付。
正式上线
在商户门户创建 API 密钥，或直接在控制台手动下单。
安全
放心重试，不易误用
每笔订单都会动用您的余额，所以每个密钥、每位成员都只拿到工作必需的权限。
幂等下单
同一个 Idempotency-Key 发送两次，也只会生成一笔订单。
签名 Webhook
每条事件都带有 HMAC-SHA256 签名，先验签，再采信。
限定权限的密钥与 IP 白名单
每个密钥只授予必需的权限范围，还可选设 IP 白名单和到期日期。
双重验证登录
每位成员都用自己的账户登录，并可开启双重验证加以保护。
六种团队角色
所有者、管理员、财务、开发者、客服和查看者。每个角色只能看到工作所需的内容。
企业均经审核
每家企业在工作区开通前都要经过我们的审核，订单也会按照我们的反洗钱（AML）与 KYC 制度接受筛查。
- 批发价格
- 报价总额就是从余额中扣除的金额，分毫不差。
- 不按调用收费
- 每个工作区每分钟可发起 120 次请求。
- 预付制，绝不透支
- 订单先预留金额，交付后才扣款。订单失败则释放预留。
- 提现清清楚楚
- 提取未使用的资金前，手续费、实收金额和到账日期都会先列明。
任何已注册的企业都可以。在您的 Xegora 账户中提交公司注册信息，我们的团队审核后才会开通工作区。
不需要。您可以在商户控制台中搜索目录、查询价格并手动下单。之后想实现自动化，再接入 API 即可。
从工作区的预付余额中支付，余额可通过 USDT或USDC 充值。每笔订单会先预留相应金额，交付后才正式扣款；订单失败则释放预留。
没有。用密钥下的每一笔订单都是真实购买，会从您的余额中扣款，所以建议先用一笔小额订单测试您的流程。
您通过 API 或控制台获取兑换码，再通过自己的应用或消息交付给客户。每次查看都有记录。
可以。添加拥有已验证邮箱 Xegora 账户的同事，并为每人分配一个角色：所有者、管理员、财务、开发者、客服或查看者。
