Pending. A ação de pagamento acessará o canal de pagamento e poderá alterar o status do pedido; antes de chamar, é necessário confirmar o ID do pedido, o valor e o método de pagamento.
Visão geral da interface
Limites do pagamento anônimo
O acesso anônimo é usado em cenários em que a sessão de login é perdida após abrir um link de pagamento copiado, não exige e não deve carregar um Account Token de longo prazo. Chamadas anônimas:- Apenas permitem métodos de pagamento de redirecionamento hospedado configurados pelo servidor;
- Usam fixamente a página de pagamento para desktop;
- Não podem resgatar pedidos de valor zero;
- Estão sujeitas a limitação de taxa por IP e por pedido individual;
- Retornam uma projeção mínima do pedido, sem conta, Application ou metadata interno.
Exemplos de solicitação
pay_way usa valores reais suportados pelo modelo de pedido, por exemplo, WechatPay, AliPay, Stripe, Card, Airwallex, X402, PayPal, AppleIAP, Reward, BankTransfer. Nem todos os valores estão disponíveis para solicitações anônimas ou em todos os sites.
Descrição da resposta
Uma resposta bem-sucedida é o objeto de pedido atualizado, normalmente fornecendo a entrada para a próxima etapa por meio depay_url; diferentes métodos de pagamento também podem retornar, em campos controlados, as informações necessárias para que o cliente continue o pagamento. A resposta anônima usa uma lista branca mínima de campos; o proprietário autenticado obtém detalhes completos.
Não dependa de nomes de campos antigos como payment_url, qr_code_url ou payment_method; o contrato atual de Order usa pay_url e pay_way.
Transferência bancária
Contas pessoais e empresariais conectadas podem usarBankTransfer, sem necessidade de autenticação empresarial. Tanto transferências domésticas em RMB quanto transferências internacionais em USD exigem que o valor do pedido seja de pelo menos 300 dólares americanos; o valor em RMB a pagar prevalece conforme exibido no momento do pagamento.
Antes de pagar, é possível consultar as rotas de transferência e os limites de valor disponíveis para o pedido atual por meio de GET /api/v1/orders/{order_id}/payment-options/. A transferência bancária deve ser iniciada após o login pelo proprietário do pedido e está sujeita à configuração do canal de recebimento e às limitações de aplicabilidade do plano; solicitações anônimas não podem usá-la.
Compras no app do iOS
O proprietário do pedido conectado pode enviarpay_way: "AppleIAP". Esta solicitação atualiza o pedido pendente de pagamento de acordo com metadata.apple_price do plano selecionado e remove os descontos, não gera cobrança, não concede créditos e não retorna um link de pagamento. Pedidos pendentes de pagamento antigos devem primeiro concluir esta etapa e depois iniciar o pagamento nativo da Apple. É suportado apenas um plano Usage com produto e preço Apple configurados; planos não suportados ou pedidos em lote retornam 400.
Após o pagamento nativo da Apple, envie transaction_id por meio de /api/v1/orders/{id}/apple-verify/ para concluir a verificação no servidor e a concessão de créditos. A quantidade de créditos vem do plano; o valor usa o preço predefinido independente em dólares americanos da Apple, sem acumular descontos de assinatura ou acréscimos do site, e o valor cobrado na moeda local em outras regiões prevalece conforme a página de confirmação da Apple.
Erros e novas tentativas
- O pedido não é
Pending: retorna400; não crie repetidamente sessões de pagamento. pay_waynão foi fornecido: pedidos de valor diferente de zero retornam400.- Uma chamada anônima usa um método não permitido ou um pedido de valor zero: retorna
403; faça login e tente novamente como proprietário. - Autenticado, mas não é o proprietário do pedido: retorna
403. - Falha do canal de pagamento: não reenvie cegamente; primeiro consulte os detalhes do pedido, confirme que ele ainda está
Pendinge então tente novamente.

