Pular para o conteúdo

Guatemala · Pay-ins 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.

Fale com vendasDocumentação: Guatemala
  • QR Fri · Wallet Fri · IFT
  • Moeda: GTQ
  • Registrada
Pay-ins
QR Fri
Pay-ins
Wallet Fri
Payouts
GTQ
Registrada em
SAT

Panorama do mercado

Guatemala em números

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

Panorama do mercado

QR e carteiras em quetzales

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 pay-in 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
Compare todos os meios de pagamento

Experiência de checkout

Como os clientes pagam na Guatemala

Escolha um meio de pagamento para ver o checkout passo a passo. Telas e valores ilustrativos.

QR Fri (SoyFri)

  1. 1Comercio EjemploO cliente escolhe QR Fri (SoyFri) para pagar GTQ 2.000.
  2. 2QR Fri (SoyFri)O pagador vê um QR Code (ou um código para copiar e colar).
  3. 3Banco EjemploO pagador confere GTQ 2.000 e aprova no app do banco ou da carteira.
  4. 4Pagamento confirmadoSeu sistema recebe o webhook assinado e libera o pedido.

Pay-ins

Métodos de pay-in 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

Pay-in 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
Ver todas as licenças

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
Guia do país na documentação
# 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>" }
      }
    }
  }'

Mercados próximos

Continue expandindo na região

A mesma API e o mesmo Business Portal em todos os mercados.

Perguntas frequentes

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

Pay-ins: 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.

Produtos relacionados

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.

Fale com vendasIr para a documentação

Como podemos ajudar?

Baixe o seu exemplar

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