Pular para o conteúdo

Guatemala · Payins e payouts

Pagamentos por QR e carteira na Guatemala

Receba em quetzales com QR Fri, Wallet Fri e pagamentos referenciados Akisi, e faça payouts para contas bancárias guatemaltecas via IFT e ACH.

  • QR Fri · Wallet Fri · IFT
  • Moeda: GTQ
  • Registrada · SAT
QR Fri
Payins
Wallet Fri
Payins
GTQ
Payouts
SAT
Registrada em

Panorama do mercado

Guatemala em números

Números públicos e datados de fontes oficiais. Cada número leva à sua fonte.

QR e carteiras em quetzales

Por que a Localpayment na Guatemala

Na Guatemala, a Localpayment recebe em quetzales (GTQ) pelo ecossistema de QR e carteira Fri e por pagamentos referenciados Akisi, e faz payouts para contas bancárias via IFT e ACH. A Localpayment está registrada para payin e payout na Superintendência de Administração Tributária (SAT).

  • QR Fri e Wallet Fri de GTQ 1 a 10.000

  • Pagamentos referenciados Akisi de GTQ 20 a 7.500

  • Payouts IFT de até GTQ 20.000, D+1

  • Payouts ACH acima de GTQ 20.000, D+1

Fale com nosso time de vendas

Conte quais são seus mercados e volumes, e desenhamos a integração com você.

Meios de pagamento

Todos os meios na Guatemala, em resumo

Cada meio documentado com prazo e limites. Os detalhes completos estão mais abaixo nesta página.

Payins

Métodos de payin na Guatemala

Cada método documentado, com o código na API, os limites e como cada pagamento é confirmado.

  • QR Fri (SoyFri)

    Tipo
    QR
    Código
    1870
    Limites
    GTQ 1 – 10.000
    Confirmação
    Assíncrono, confirmado por webhook
    Observações
    O pagador aprova o pagamento no app do banco ou da carteira
  • Wallet Fri

    Tipo
    Carteira digital
    Código
    1880
    Limites
    GTQ 1 – 10.000
    Confirmação
    Assíncrono, confirmado por webhook
    Observações
    —
  • Pagamentos referenciados Akisi

    Tipo
    Pagamento referenciado
    Código
    1811
    Limites
    GTQ 20 – 7.500
    Confirmação
    Assíncrono, confirmado por webhook
    Observações
    Pagamento online com número de referência

Os códigos são os valores de paymentMethod.code na API. Limites conforme docs.localpayment.com; a disponibilidade final depende do seu contrato.

Payouts

Trilhos de payout na Guatemala

Cada trilho documentado, com prazo, horário de corte e limites.

  • Transferência bancária (IFT)

    Tipo
    Transferência bancária
    Código
    0110
    Prazo / corte
    D+1 (próximo dia útil), corte às 12h (horário local)
    Limites
    GTQ 1 – 20.000
    Observações
    —
  • Transferência bancária (ACH)

    Tipo
    Transferência bancária
    Código
    0110
    Prazo / corte
    D+1 (próximo dia útil), corte às 12h (horário local)
    Limites
    Acima de GTQ 20.000
    Observações
    —

Os códigos são os valores de paymentMethod.code na API. Limites conforme docs.localpayment.com; a disponibilidade final depende do seu contrato.

Licença e regulação

Guatemala: presença registrada

Payin e payout: Superintendência de Administração Tributária (SAT). Antes de entrar em produção, cada empresa passa por uma revisão de compliance (due diligence ou due diligence reforçada) e pela verificação da empresa (KYB).

  • Situação: registrada
  • Credenciais de produção após os testes em Stage, uma revisão de segurança e o KYB
  • Documentos aceitos: NIT, CUI
  • TLS 1.2+, criptografia AES-256 em repouso, MFA e webhooks assinados com HMAC

Para desenvolvedores

Envie seu primeiro payout na Guatemala

Obtenha um token de acesso com POST /api/token/ e chame POST /api/payout/ com o código do trilho e o código do país (ISO-3). Teste primeiro em Stage: nenhum dinheiro real é movimentado.

  • País GTM · moeda GTQ
  • Trilho: Transferência bancária (IFT) · código 0110
  • Status final por webhook assinado com HMAC
# Requisição ilustrativa com campos simplificados. Veja a página do país em docs.localpayment.com
# ACCESS_TOKEN vem de POST /api/token/ e vale por 5 minutos
curl -X POST https://api.stage.localpayment.com/api/payout/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "payout-gt-000184",
    "country": "GTM",
    "currency": "GTQ",
    "amount": 2000,
    "paymentMethod": {
      "type": "BankTransfer",
      "code": "0110",
      "flow": "DIRECT"
    },
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "beneficiary": {
      "type": "INDIVIDUAL",
      "name": "Sofía",
      "lastname": "López",
      "document": { "type": "NIT", "id": "0000000-0" },
      "bank": {
        "account": { "number": "<beneficiary-account-number>" }
      }
    }
  }'

Perguntas frequentes

Quais métodos estão disponíveis na Guatemala?

Payins: QR Fri (SoyFri), Wallet Fri e Pagamentos referenciados Akisi. Payouts: Transferência bancária (IFT) e Transferência bancária (ACH). As tabelas acima mostram códigos, limites e prazos.

Quais meios de recebimento existem na Guatemala?

QR Fri, Wallet Fri e pagamentos online referenciados Akisi, todos confirmados por webhook.

Como funcionam os payouts na Guatemala?

Transferências de até GTQ 20.000 vão via IFT e valores maiores via ACH; ambas liquidam em D+1.

Quais documentos a API aceita?

NIT e CUI.

Como entro em produção na Guatemala?

Fale com vendas sobre seus fluxos. Após o contrato e uma revisão de compliance (due diligence ou due diligence reforçada), você recebe credenciais de Stage (ambiente de testes) para integrar sem movimentar dinheiro real. As credenciais de produção vêm depois dos testes em Stage, de uma revisão de segurança e da verificação da empresa (KYB), e você pode entrar em produção em semanas.

Comece a operar na Guatemala

Receba credenciais de Stage (ambiente de testes) no início da parceria e entre em produção em semanas. A mesma API e o mesmo Business Portal em todos os mercados.

Como podemos ajudar?

Baixe o seu exemplar

Deixe seus dados e receba a edição completa na hora.