# Conecte sua conta do Airwallex

> Receba por cartão e métodos de pagamento locais como Alipay, WeChat Pay, GrabPay e FPX com sua própria conta do Airwallex. Em Configurações > Pagamentos, clique em Configurar Airwallex, cole seu Client ID e sua API key, adicione nossa URL de webhook no Airwallex e cole o segredo dela, escolha Demo ou Live, ative e clique em Salvar configurações.

Central de Ajuda / Pagamentos - Atualizado em 19 de novembro de 2026

O Airwallex é um provedor de pagamentos para empresas na Ásia-Pacífico, na Europa e na América do Norte. Quando você conecta sua conta do Airwallex, seus clientes podem pagar com cartão ou com os métodos de pagamento locais que você ativou no Airwallex, como Alipay, WeChat Pay, GrabPay, FPX e PayNow. Os pagamentos vão direto para sua conta do Airwallex, e o Shoprocket cobra 0 %.

Quando um cliente clica em **Pague agora**, o formulário de pagamento seguro do Airwallex abre dentro do seu checkout. O cliente paga ali, sem sair da sua loja. Os dados do cartão vão direto para o Airwallex e nunca passam pelo Shoprocket.

## Antes de começar

Você precisa de uma conta do Airwallex com os pagamentos online ativados. Você também precisa de três coisas:

1. Um **Client ID** e uma **API key**. No Airwallex, vá em **Developer > API keys** e crie uma chave restrita. Dê a ela acesso de leitura e escrita a **Payment Acceptance**, e a mais nada. O Airwallex mostra a API key uma única vez, então copie-a na hora.
2. Um **webhook secret**. Você cria o webhook no Airwallex usando uma URL do Shoprocket, então vai receber o segredo durante os passos de configuração abaixo.
3. Saber se suas chaves vêm da sua conta de **demonstração** (para testar) ou da sua conta **live**.

## Conectar o Airwallex

1. No seu painel, vá em **Configurações > Pagamentos**.
2. No cartão do Airwallex em **Gateways de pagamento**, clique em **Configurar Airwallex**.
3. Cole seu **Client ID** e sua **API key** nos campos de mesmo nome.
4. Em **Environment**, escolha **Demo** para chaves da sua conta de demonstração, ou **Live** para a sua conta live.
5. Copie a **Webhook URL** mostrada abaixo dos campos.
6. No Airwallex, vá em **Developer > Webhooks** e adicione um webhook com essa URL. Assine os eventos **Payment Intent** e **Refund** e salve.
7. O Airwallex então mostra o segredo do webhook. Copie-o para o campo **Webhook secret** no Shoprocket.
8. Coloque o botão do Airwallex em **Ativado** e clique em **Salvar configurações**.

![O cartão do Airwallex em Configurações > Pagamentos: os campos de Client ID, API key, webhook secret e environment, com a URL do webhook para copiar abaixo deles](https://shoprocket.io/img/help/connect-airwallex/airwallex-setup.webp)

Quando você salva, o Shoprocket entra no Airwallex com seu Client ID e sua API key. Se o Airwallex os recusar, nada é salvo e uma mensagem no topo da tela explica o motivo. O erro mais comum é escolher o environment errado. Chaves de demonstração só funcionam com **Demo**, e chaves live só funcionam com **Live**.

O cartão passa a mostrar **Conectado**, e o Airwallex aparece no seu checkout.

## Por que o webhook importa

Alguns métodos de pagamento terminam depois que o cliente já saiu do seu checkout, por exemplo um código QR pago no aplicativo do banco. O Airwallex avisa o Shoprocket sobre cada pagamento e reembolso pelo webhook. Depois, o Shoprocket confere o pagamento com o Airwallex antes de marcar o pedido como pago. O webhook também é o que faz um reembolso feito no Airwallex aparecer no pedido no Shoprocket.

Os pagamentos com cartão são confirmados na hora, mesmo sem o webhook, mas adicione-o antes de começar a vender.

## As moedas que você pode receber

Quando você salva, o Shoprocket lê as moedas em que sua conta do Airwallex aceita pagamentos com cartão. Se um cliente finaliza a compra em uma moeda em que sua conta não aceita cartões, o pagamento não pode passar pelo Airwallex. O checkout então pede que ele escolha outra forma de pagar. Para receber mais moedas, ative-as no Airwallex e depois salve de novo suas credenciais do Airwallex no Shoprocket.

Se sua conta aceita cartões em apenas uma moeda e sua loja tem preços em outra, o cartão avisa. Você ainda pode oferecer o Airwallex a clientes que pagam nessa moeda. Para isso, adicione a moeda em **Gateway de cartão por moeda**, como explica [Escolha um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md).

## Teste no modo de demonstração

O Airwallex dá a você uma conta de demonstração com chaves próprias. Para experimentar seu checkout sem mover dinheiro de verdade, escolha **Demo** e cole suas chaves de demonstração. O cartão passa a mostrar **Credenciais de teste: nenhum dinheiro real é movimentado**. A documentação do Airwallex lista números de cartão de teste que você pode usar.

Quando estiver pronto para vender, clique em **Editar as credenciais de Airwallex**, cole seu Client ID e sua API key live, escolha **Live** e cole o segredo de um webhook que você criou na sua conta live. Depois clique em **Salvar configurações**.

## Como os clientes pagam

- **Com cartão**: o cliente digita o cartão no formulário do Airwallex, dentro do seu checkout. Se o banco dele precisar conferir o pagamento, a verificação também abre ali. Se o cartão for recusado, ele pode tentar outro no mesmo formulário.
- **Com um método de pagamento local**: o cliente o escolhe no mesmo formulário e segue os passos, como escanear um código QR ou aprovar o pagamento no aplicativo. O pedido é confirmado assim que o Airwallex avisa o Shoprocket que o pagamento foi concluído.

Um cliente que mudar de ideia pode clicar em **Escolher outra forma de pagar**, abaixo do formulário, para voltar ao carrinho.

O Apple Pay e o Google Pay ainda não estão disponíveis pelo Airwallex.

## Reembolsos

Quando você reembolsa um pedido pago com o Airwallex, o dinheiro volta automaticamente ao cliente, total ou parcialmente. Veja [Reembolse um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md). Os reembolsos saem do seu saldo no Airwallex, então mantenha o suficiente nele para cobri-los.

## Assinaturas

O Airwallex consegue renovar assinaturas. Quando um cliente compra uma assinatura, o cartão com que ele paga fica salvo na sua conta do Airwallex. Cada renovação é então cobrada nesse cartão, no calendário da assinatura.

## Alterar as credenciais ou desativar

Depois que o Airwallex está conectado, o botão dele passa a dizer **Editar as credenciais de Airwallex**. Suas credenciais salvas ficam armazenadas criptografadas e nunca são mostradas de novo. Para mantê-las, deixe os campos em branco. Para substituí-las, preencha todos os campos e clique em **Salvar configurações**.

Para deixar de oferecer o Airwallex, coloque o botão dele em **Desativado** e clique em **Salvar configurações**. Suas credenciais continuam salvas, então você pode reativá-lo quando quiser. Os pagamentos que os clientes já tinham começado continuam sendo concluídos.

## Artigos relacionados

- [Escolher um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md)
- [Reembolsar um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md)
- [Faça um pedido de teste](https://shoprocket.io/pt/ajuda/fazer-um-pedido-de-teste.md)

[Abrir Pagamentos no seu painel](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/pt/ajuda/conectar-airwallex
- Language: Português (pt)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-airwallex.md), [Deutsch](https://shoprocket.io/de/hilfe/airwallex-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-airwallex.md), [English](https://shoprocket.io/help/connect-airwallex.md), [Español](https://shoprocket.io/es/ayuda/conectar-airwallex.md), [Français](https://shoprocket.io/fr/aide/connecter-airwallex.md), [עברית](https://shoprocket.io/he/help/connect-airwallex.md), [हिन्दी](https://shoprocket.io/hi/help/connect-airwallex.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-airwallex.md), [Italiano](https://shoprocket.io/it/aiuto/collega-airwallex.md), [日本語](https://shoprocket.io/ja/help/connect-airwallex.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-airwallex-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-airwallex-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/airwallex-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-airwallex.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-airwallex.md), [Русский](https://shoprocket.io/ru/help/connect-airwallex.md), [ไทย](https://shoprocket.io/th/help/connect-airwallex.md), [Türkçe](https://shoprocket.io/tr/yardim/airwallex-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-airwallex.md)
