Pular para o conteúdo

Checkout

Escolha um caminho de checkout que combine com a sua equipe.

Checkout hospedado, links de pagamento, formulários incorporados ou Smart Fields. Menos dados de cartão nos seus servidores.

  • Opções sem código
  • Campos de cartão hospedados
  • Tokens de uso único
Opções de checkout na mesma plataforma de pay-ins
4
Links de pagamento que você compartilha por e-mail, SMS ou chat
Sem código
Campos de cartão hospedados que reduzem o seu escopo PCI
Smart Fields
Onde você configura aparência, catálogo e chaves
Business Portal

Smart Fields

Do cartão ao pagamento em quatro passos

  1. 01

    Carregue o SDK

    Inclua localpayment-sdk.min.js e inicialize com o seu código de cliente e a chave de API dos Smart Fields.

  2. 02

    Monte os campos

    Crie os campos pan, cvv e expiration e monte-os nos contêineres do seu formulário.

  3. 03

    Consolide

    O seu backend troca o ID de sessão por um token de uso único pelo endpoint consolidate.

  4. 04

    Cobre

    Crie o pay-in com o token no lugar dos dados do cartão. Os dados de cartão nunca chegam aos seus servidores.

Para desenvolvedores

Transforme uma sessão dos Smart Fields em pagamento

No navegador, o SDK captura o cartão em campos hospedados e entrega um ID de sessão. No seu servidor, troque-o por um token de uso único e crie o pay-in.

  • SDK de Stage: sdk.stage.localpayment.com/localpayment-sdk.min.js
  • Tokens de uso único, um por pagamento
  • O mesmo endpoint Create Payin dos demais métodos
# Ilustrativo: endpoints de Stage e valores fictícios; veja o guia dos Smart Fields
# 1) Troque a sessão dos Smart Fields por um token de uso único
# LP_TOKENIZATION_URL: host de tokenização do seu ambiente (veja o guia dos Smart Fields)
curl -X POST "$LP_TOKENIZATION_URL/api/tokenization/consolidate" \
  -H "Authorization: Bearer $SESSION_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "clientCode": "<your-client-code>",
    "sessionId": "<session-id-from-the-sdk>",
    "CardholderName": "Lucía Méndez"
  }'

# 2) Crie o pay-in com esse token
curl -X POST https://api.stage.localpayment.com/api/payin/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": { "type": "CreditCard", "code": "1904", "flow": "DIRECT" },
    "externalId": "a41d7e20-0000-4000-8000-000000000077",
    "country": "COL",
    "currency": "COP",
    "amount": 185000,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S." },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Lucía",
      "lastname": "Méndez",
      "document": { "type": "CC", "id": "1000000000" }
    },
    "card": { "token": "<single-use-token>" }
  }'

Do seu jeito

Configure o checkout pelo Business Portal

Aparência, catálogo e chaves em um só lugar, para que a equipe de operações ajuste o checkout sem esperar uma nova publicação.

  • Defina a cor da marca do iframe incorporado e dos links de pagamento
  • Salve itens frequentes para WebCheckout e links de pagamento
  • Gerencie as chaves do iframe e as chaves de API dos Smart Fields
  • Acompanhe cada pagamento nos mesmos relatórios do seu tráfego via API

Casos de uso

O checkout certo para cada canal de venda

Perguntas frequentes

Com qual opção de checkout devo começar?

Muitas empresas começam com links de pagamento ou WebCheckout porque não exigem integração, e depois migram para o iframe incorporado ou os Smart Fields conforme o checkout amadurece.

O que o escopo PCI significa para a minha equipe?

É a parte dos seus sistemas sujeita aos requisitos do PCI DSS. As opções hospedadas mantêm os dados de cartão conosco, o que reduz esse escopo; o seu QSA confirma as obrigações finais.

Quais métodos de pagamento as opções hospedadas aceitam?

O WebCheckout aceita cartões de crédito, cartões de débito e transferências bancárias. Os links de pagamento e o iframe incorporado mostram os métodos habilitados para a sua conta, incluindo cartões e transferências. O Smart Fields captura apenas dados de cartão.

Preciso de um SDK no servidor?

Não. Não há SDKs oficiais de servidor: o seu backend chama a API REST diretamente. Os Smart Fields usam um SDK JS no lado do cliente.

Posso testar antes de entrar em produção?

Sim. Os Smart Fields e as demais opções de checkout podem ser testados no Stage, que espelha a produção sem dinheiro real.

Posso aplicar minha marca ao checkout hospedado?

Sim. No Business Portal você define a cor da marca do iframe incorporado e dos links de pagamento, sem mudanças de código.

Por quanto tempo um link de pagamento é válido?

O cliente precisa pagar em até 8 horas após abrir o link pela primeira vez. Depois disso ele expira, e você envia um novo link para cobrar.

Escolha o seu caminho e entre em produção

Comece hoje com um link e evolua para um checkout totalmente nativo quando estiver pronto.

Como podemos ajudar?

Baixe o seu exemplar

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