# Conecte sua conta do Xendit

> Receba por cartão, QRIS, carteiras digitais e transferência bancária no Sudeste Asiático com sua própria conta do Xendit. Em Configurações > Pagamentos, clique em Configurar Xendit, cole sua Secret API key e o webhook verification token, escolha seu país, adicione nossa URL de webhook no Xendit, ative e clique em Salvar configurações.

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

O Xendit é um provedor de pagamentos para empresas na Indonésia, nas Filipinas, no Vietnã, na Tailândia, em Singapura e na Malásia. Quando você conecta sua conta do Xendit, seus clientes podem pagar com cartão, escaneando um código QRIS, com carteiras digitais como OVO, DANA, GoPay, ShopeePay, GCash e Maya, por transferência bancária para uma conta virtual ou em um ponto de pagamento físico, dependendo dos métodos de pagamento que você ativou no Xendit. Os pagamentos vão direto para sua conta do Xendit, e o Shoprocket cobra 0 %.

Quando um cliente clica em **Pague agora**, ele vai para a página de pagamento segura do Xendit para escolher como pagar e depois volta para a sua loja. Os dados do cartão vão direto para o Xendit e nunca passam pelo Shoprocket.

## Antes de começar

Você precisa de uma conta do Xendit e de três coisas do painel do Xendit:

1. Sua **Secret API key**, em **Settings > API keys**. Ao criar a chave, dê a ela acesso de escrita a **Money-in**, para que ela possa receber pagamentos e fazer reembolsos.
2. Seu **webhook verification token**, em **Settings > Webhooks**.
3. O país em que sua conta do Xendit está registrada.

## Conectar o Xendit

1. No seu painel, vá em **Configurações > Pagamentos**.
2. No cartão do Xendit em **Gateways de pagamento**, clique em **Configurar Xendit**.
3. Cole sua **Secret API key** e seu **Webhook verification token** nos campos de mesmo nome.
4. Em **País**, escolha o país em que sua conta do Xendit está registrada.
5. Copie a **Webhook URL** mostrada abaixo dos campos.
6. No painel do Xendit, vá em **Settings > Webhooks**. Cole a URL nos campos de webhook de **Payment Session**, **Payments** e **Refunds** e salve.
7. De volta ao Shoprocket, coloque o botão do Xendit em **Ativado** e clique em **Salvar configurações**.

![O cartão do Xendit em Configurações > Pagamentos: os campos da chave secreta, do token de webhook e do país, com a URL do webhook para copiar abaixo deles](https://shoprocket.io/img/help/connect-xendit/xendit-setup.webp)

Quando você salva, o Shoprocket confere sua chave secreta com o Xendit. Se o Xendit a recusar, nada é salvo e uma mensagem no topo da tela explica o motivo. O erro mais comum é colar a chave pública, que começa com `xnd_public_`. A chave secreta começa com `xnd_development_` ou `xnd_production_`.

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

## Por que a URL do webhook importa

Muitos clientes no Sudeste Asiático terminam de pagar fora da sua loja. Um cliente pode escanear um código QRIS no aplicativo do banco, aprovar um pagamento de carteira digital no celular ou pagar uma conta virtual horas depois. O Xendit avisa o Shoprocket sobre cada pagamento pela URL do webhook. Depois, o Shoprocket confere o pagamento com o Xendit antes de marcar o pedido como pago.

Sem o webhook, um pedido pago desse jeito pode ficar **Em processamento** até o cliente voltar à sua loja. Adicione a URL no Xendit antes de começar a vender.

## A moeda que sua conta aceita

Cada conta do Xendit recebe na moeda do próprio país: rupia indonésia, peso filipino, dongue vietnamita, baht tailandês, dólar de Singapura ou ringgit malaio. O país que você escolhe define a moeda, e o cartão a mostra depois que você salva.

Se os preços da sua loja estão em outra moeda, o cartão avisa. Nesse caso, o Xendit não pode ser seu gateway de cartão principal, mas você ainda pode oferecê-lo a clientes que pagam na moeda dele. Para isso, adicione essa 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).

O Xendit recebe rupias em valores inteiros. Se um preço tem centavos, ele é arredondado para a rupia mais próxima quando o cliente paga.

## Teste no modo de teste

O Xendit dá a cada conta um modo de teste com uma chave secreta própria, que começa com `xnd_development_`. Cole a chave de teste para experimentar o checkout sem mover dinheiro de verdade. O cartão passa a mostrar **Credenciais de teste: nenhum dinheiro real é movimentado**. Na página de pagamento de teste do Xendit, você pode simular um pagamento bem-sucedido para cada método de pagamento.

Quando estiver pronto para vender, clique em **Editar as credenciais de Xendit**, cole sua chave secreta live (ela começa com `xnd_production_`), escolha seu país de novo e clique em **Salvar configurações**. O webhook verification token e as URLs de webhook são definidos separadamente para o modo de teste e o modo live no Xendit, então adicione a URL também no modo live.

## Como os clientes pagam

- **Com cartão**: o cliente digita o cartão na página do Xendit. Se o banco dele precisar conferir o pagamento, a verificação também abre ali.
- **Com QRIS ou carteira digital**: o cliente escaneia o código ou aprova o pagamento no aplicativo da carteira. O pedido é confirmado assim que o Xendit nos avisa que o pagamento foi concluído.
- **Com conta virtual ou em um ponto de pagamento físico**: o cliente recebe um número para pagar. O pedido fica **Em processamento** até ele pagar, e os itens continuam reservados enquanto a página de pagamento do Xendit estiver aberta.

Se um cliente sair da página do Xendit sem pagar, ele pode clicar em **Pague agora** de novo no carrinho para voltar à mesma página. Quando a página expira, uma nova se abre.

## Reembolsos

Quando você reembolsa um pedido pago com o Xendit, o dinheiro volta automaticamente ao cliente, total ou parcialmente. Veja [Reembolse um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md). Algumas carteiras digitais e métodos de pagamento bancários não podem ser reembolsados parcialmente, ou de forma nenhuma, pelo Xendit. Quando isso acontece, o reembolso aparece como falho, com o motivo. Você pode então reembolsar o valor total ou devolver o dinheiro ao cliente por conta própria. Um reembolso feito no painel do Xendit também aparece no pedido no Shoprocket.

Os reembolsos saem do seu saldo no Xendit, então mantenha o suficiente nele para cobri-los.

## Assinaturas

O Xendit ainda não consegue renovar assinaturas no Shoprocket. Se você vende assinaturas, mantenha outro gateway de cartão que as renove, como o Stripe, para esses produtos.

## Alterar as credenciais ou desativar

Depois que o Xendit está conectado, o botão dele passa a dizer **Editar as credenciais de Xendit**. 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 os três campos e clique em **Salvar configurações**.

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