From 6c21f1c7bdc36b97721827de5bd25380ef7ef7c1 Mon Sep 17 00:00:00 2001 From: hallstain Date: Tue, 11 Aug 2026 17:45:07 +0300 Subject: [PATCH] docs(third-party-payouts): say where a WeChat relationship is actually refused The refusal lives in the payout, not in the quote: the order is created and then cancelled. Saying "before any money moves" read as an API-level rejection. Co-Authored-By: Claude Opus 5 --- api-reference/third-party-payouts.md | 5 ++++- changelog.md | 2 +- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/api-reference/third-party-payouts.md b/api-reference/third-party-payouts.md index 836e008..b8566e4 100644 --- a/api-reference/third-party-payouts.md +++ b/api-reference/third-party-payouts.md @@ -164,7 +164,10 @@ The two wallets also differ in what the payment may be: `sender_recipient_relationship` on the quote is what states which of those this payment is, so a `wechat-pay` destination sent as `supplier`, `employee` or -`friend` cannot settle and is refused before any money moves. And because the +`friend` cannot settle. The quote and the order are accepted, and the payout is +then refused and the order cancelled — nothing reaches the beneficiary, but the +order does not complete either. Send those beneficiaries to `alipay` or to a bank +format. And because the remitter has to be your own paying customer (see *The sender on consumer-to-consumer rails*), a payment to the sender themselves is only possible when that customer is Chinese. diff --git a/changelog.md b/changelog.md index bccfa6f..8761e0a 100644 --- a/changelog.md +++ b/changelog.md @@ -7,7 +7,7 @@ Notable changes to the Unigox partner API, newest first. **Chinese mobile wallets pay Chinese nationals only, and WeChat pays fewer of them than Alipay.** Both wallets verify the account holder against a Chinese national ID, so a foreign resident's Alipay or WeChat account cannot receive on the `ewallet` format — use a bank format for those beneficiaries. - `alipay` settles to the sender themselves, to family, or to a third party. -- `wechat-pay` settles to the sender themselves or to family only. A `wechat-pay` destination quoted as `supplier`, `employee` or `friend` is refused before any money moves. +- `wechat-pay` settles to the sender themselves or to family only. A `wechat-pay` destination quoted as `supplier`, `employee` or `friend` is refused at payout and the order is cancelled — nothing reaches the beneficiary. Route those to `alipay` or to a bank format. - The receiving wallet may ask the beneficiary to evidence the declared relationship (proof of income for a payment to the sender themselves, proof of the relationship for family). A relationship the beneficiary cannot evidence is what leaves a payment held inside the wallet. - Paying a Chinese company from your company (B2C) is not available on this rail yet.