Pulse API

Sua App (JSON)          Axon Pulse                    Bandeiras (ISO 8583)
┌──────────┐     ┌─────────────────────┐     ┌──────────────────────┐
│          │     │  API    Service     │     │                      │
│  POST    │────>│  Layer   Layer      │     │  Visa (TCP :10000)   │
│  /v1/    │     │    │       │        │────>│                      │
│  trx/    │     │    │   ISO 8583     │     └──────────────────────┘
│  auth    │     │    │   Builder      │
│          │<────│    │       │        │     ┌──────────────────────┐
│  JSON    │     │    │   ISO 8583     │     │                      │
│  resp    │     │    │   Parser       │<────│  Mastercard          │
│          │     │    │       │        │     │  (TCP :10000)        │
└──────────┘     │    └───────┘        │     └──────────────────────┘
                 │        │            │
                 │   ┌────▼────┐       │
                 │   │ Postgres│       │
                 │   │ (state) │       │
                 │   └─────────┘       │
                 └─────────────────────┘

Sandbox:    https://sandbox.pulse.axon.com
Production: https://pulse.axon.com

{
  "card_token": "vault_card_abc123def456",
  "amount": 25990,
  "currency": "BRL",
  "merchant_id": "LOJA_ONLINE_01",
  "terminal_id": "ECOMM001",
  "installments": 3,
  "capture": false
}

{
  "id": "txn_f7g8h9i0j1k2",
  "status": "authorized",
  "amount": 25990,
  "currency": "BRL",
  "auth_code": "789012",
  "response_code": "00",
  "response_message": "Transacao aprovada",
  "brand": "mastercard",
  "merchant_id": "LOJA_ONLINE_01",
  "installments": 3,
  "created_at": "2026-02-07T14:00:00Z"
}

{
  "id": "txn_f7g8h9i0j1k2",
  "status": "declined",
  "amount": 25990,
  "currency": "BRL",
  "auth_code": "",
  "response_code": "51",
  "response_message": "Saldo insuficiente",
  "brand": "mastercard",
  "merchant_id": "LOJA_ONLINE_01",
  "installments": 3,
  "created_at": "2026-02-07T14:00:00Z"
}

{
  "amount": 25990
}

{
  "id": "txn_f7g8h9i0j1k2",
  "status": "captured",
  "amount": 25990,
  "captured_amount": 25990,
  "currency": "BRL",
  "auth_code": "789012",
  "response_code": "00",
  "response_message": "Captura realizada com sucesso",
  "brand": "mastercard",
  "merchant_id": "LOJA_ONLINE_01",
  "captured_at": "2026-02-08T09:00:00Z"
}

{
  "id": "txn_m3n4o5p6q7r8",
  "status": "voided",
  "amount": 5000,
  "currency": "BRL",
  "auth_code": "345678",
  "response_code": "00",
  "response_message": "Estorno realizado com sucesso",
  "brand": "visa",
  "merchant_id": "RESTAURANTE_42",
  "voided_at": "2026-02-07T15:30:00Z"
}

{
  "id": "txn_f7g8h9i0j1k2",
  "status": "captured",
  "amount": 25990,
  "currency": "BRL",
  "auth_code": "789012",
  "response_code": "00",
  "response_message": "Transacao aprovada",
  "brand": "mastercard",
  "merchant_id": "LOJA_ONLINE_01",
  "terminal_id": "ECOMM001",
  "installments": 3,
  "created_at": "2026-02-07T14:00:00Z",
  "updated_at": "2026-02-08T09:00:00Z"
}

                  ┌──────────┐
                  │ declined │  (response_code != "00")
                  └──────────┘
                       ▲
                       │
 ┌─────────┐     ┌────┴──────┐     ┌──────────┐
 │ pending  │────>│authorized │────>│ captured  │
 └─────────┘     └─────┬─────┘     └─────┬─────┘
                       │                  │
                       │    ┌────────┐    │
                       └───>│ voided │<───┘
                            └────────┘

# 1. Autorizar transacao (3x de R$ 259,90)
curl -X POST https://pulse.axon.com/v1/transactions/authorize \
  -H "Content-Type: application/json" \
  -d '{
    "card_token": "vault_card_abc123def456",
    "amount": 25990,
    "currency": "BRL",
    "merchant_id": "LOJA_ONLINE_01",
    "installments": 3
  }'

# Response: { "id": "txn_f7g8h9i0j1k2", "status": "authorized", ... }

# 2. Capturar apos envio do produto
curl -X POST https://pulse.axon.com/v1/transactions/txn_f7g8h9i0j1k2/capture \
  -H "Content-Type: application/json" \
  -d '{ "amount": 25990 }'

# Response: { "id": "txn_f7g8h9i0j1k2", "status": "captured", ... }

# 1. Autorizar
curl -X POST https://pulse.axon.com/v1/transactions/authorize \
  -H "Content-Type: application/json" \
  -d '{
    "card_token": "vault_card_xyz789uvw012",
    "amount": 5000,
    "currency": "BRL",
    "merchant_id": "RESTAURANTE_42"
  }'

# Response: { "id": "txn_m3n4o5p6q7r8", "status": "authorized", ... }

# 2. Estornar (cliente desistiu)
curl -X POST https://pulse.axon.com/v1/transactions/txn_m3n4o5p6q7r8/void

# Response: { "id": "txn_m3n4o5p6q7r8", "status": "voided", ... }

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

type AuthRequest struct {
    CardToken  string `json:"card_token"`
    Amount     int    `json:"amount"`
    Currency   string `json:"currency"`
    MerchantID string `json:"merchant_id"`
}

type Transaction struct {
    ID              string `json:"id"`
    Status          string `json:"status"`
    Amount          int    `json:"amount"`
    AuthCode        string `json:"auth_code"`
    ResponseCode    string `json:"response_code"`
    ResponseMessage string `json:"response_message"`
    Brand           string `json:"brand"`
}

func main() {
    req := AuthRequest{
        CardToken:  "vault_card_abc123def456",
        Amount:     10000, // R$ 100,00
        Currency:   "BRL",
        MerchantID: "LOJA_01",
    }

    body, _ := json.Marshal(req)
    resp, err := http.Post(
        "https://pulse.axon.com/v1/transactions/authorize",
        "application/json",
        bytes.NewReader(body),
    )
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var txn Transaction
    json.NewDecoder(resp.Body).Decode(&txn)

    if txn.ResponseCode == "00" {
        fmt.Printf("Aprovada! Auth code: %s\n", txn.AuthCode)
    } else {
        fmt.Printf("Negada: %s\n", txn.ResponseMessage)
    }
}

const authorize = async (cardToken, amount, merchantId) => {
  const response = await fetch(
    'https://pulse.axon.com/v1/transactions/authorize',
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        card_token: cardToken,
        amount,        // centavos: 10000 = R$ 100,00
        currency: 'BRL',
        merchant_id: merchantId,
      }),
    }
  );

  const txn = await response.json();

  if (txn.response_code === '00') {
    console.log('Aprovada!', txn.id, txn.auth_code);

    // Capturar quando pronto
    await fetch(
      `https://pulse.axon.com/v1/transactions/${txn.id}/capture`,
      { method: 'POST', headers: { 'Content-Type': 'application/json' } }
    );
  }

  return txn;
};

1. POST /v1/transactions/authorize (JSON)
2. Resolve card_token -> PAN via Vault
3. Identifica bandeira pelo BIN (4xxx=Visa, 51-55xxx=MC)
4. Gera STAN e RRN
5. Monta ISO 8583 0100 (MTI + bitmap + data elements)
6. Envia bytes via TCP para bandeira
7. Recebe resposta 0110 (bytes)
8. Parseia: extrai DE38 (auth_code), DE39 (response_code)
9. Persiste transacao no PostgreSQL
10. Retorna JSON para o chamador

{
  "error": {
    "code": "INVALID_AMOUNT",
    "message": "O valor da transacao deve ser maior que zero",
    "details": {
      "field": "amount",
      "value": -100
    }
  }
}