Cartao

​

Como funciona

• voce nao precisa enviar acquirer no fluxo normal
• a AXNPAY identifica o checkout de cartao ativo na sua conta
• o frontend recebe apenas configuracoes publicas e dados seguros
• a confirmacao oficial continua chegando pelo webhook da AXNPAY

​

Endpoints

• GET /v1/integrations/card/config
• POST /v1/integrations/create-transaction
• GET /v1/integrations/card/checkout-session

​

Passo 1. Ler a configuracao publica do checkout

GET /v1/integrations/card/config
Authorization: Bearer sk_live_prod_<sua_secret_key>

• publishableKey
• supportedUiModes
• defaultUiMode
• isReadyForHostedCheckout
• isReadyForSelfHostedCheckout

​

Passo 2. Gerar a cobranca

POST /v1/integrations/create-transaction
Authorization: Bearer sk_live_prod_<sua_secret_key>
Content-Type: application/json

​

Exemplo hosted

{
  "amount": 150,
  "currency": "brl",
  "productName": "Pedido #1001",
  "description": "Plano Premium",
  "clientName": "Maria",
  "clientEmail": "maria@example.com",
  "referenceId": "9e4a5fb4-61bb-4b38-9bb6-b7029b74bdf6",
  "checkoutUiMode": "hosted",
  "paymentMethodTypes": ["card", "link"],
  "successUrl": "https://merchant.example.com/checkout/success",
  "cancelUrl": "https://merchant.example.com/checkout/cancel",
  "tracking_parameters": {
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "launch"
  }
}

​

Exemplo self-hosted

{
  "amount": 150,
  "currency": "brl",
  "productName": "Pedido #1001",
  "clientEmail": "maria@example.com",
  "referenceId": "ef17ad6d-b9f7-4130-b0e9-4f7fd704b151",
  "checkoutUiMode": "custom",
  "paymentMethodTypes": ["card", "link"],
  "returnUrl": "https://merchant.example.com/checkout/return"
}

​

Campos importantes

• nao envie acquirer no fluxo padrao
• checkoutUiMode: "hosted" | "embedded" | "custom"
• paymentMethodTypes
• successUrl e cancelUrl para hosted
• returnUrl para embedded ou custom
• tracking_parameters para UTMs

​

Wallets e metodos

• Apple Pay: use card
• Google Pay: use card
• Link: adicione link
• wallets adicionais aparecem automaticamente quando o checkout ativo suportar o metodo

{
  "paymentMethodTypes": ["card", "link"]
}

​

Passo 3. Interpretar a resposta

​

Campos mais importantes de checkout

• sessionId
• uiMode
• url para redirect hosted
• clientSecret para self-hosted
• publishableKey para o frontend
• paymentStatus
• status

​

Passo 4. Consultar o status depois

GET /v1/integrations/card/checkout-session?transactionId=<uuid>

• sessionId
• id legado

​

Webhook final para o merchant

• checkoutSessionId
• paymentIntentId
• trackingParameters
• tracking_parameters
• campos planos utm_*