Create Transaction

{
  "amount": 500,
  "currency": "BRL",
  "paymentMethod": "PIX",
  "installments": 1,
  "customer": {
    "id": "CUST-1729131560000",
    "name": "Joao Teste",
    "email": "joao.teste+1729131560000@exemplo.com",
    "document": { "number": "24577481600", "type": "CPF" },
    "phone": "11987654321",
    "externalRef": "LEAD-1234"
  },
  "shipping": {
    "fee": 0,
    "address": {
      "street": "Rua dos Testes",
      "streetNumber": "123",
      "complement": "Sala 2",
      "zipCode": "01001000",
      "neighborhood": "Centro",
      "city": "Sao Paulo",
      "state": "SP",
      "country": "BR"
    }
  },
  "items": [
    {
      "title": "Produto X",
      "unitPrice": 500,
      "quantity": 1,
      "tangible": true,
      "externalRef": "SKU-001"
    }
  ],
  "pix": { "expiresInDays": 1 },
  "postbackUrl": "",
  "metadata": "{\"origem\":\"n8n\",\"ambiente\":\"homologacao\"}",
  "traceable": true,
  "ip": "177.123.45.67"
}

{
  "data": {
    "id": "6dcf2aee0d6148e1a12b78db78",
    "externalRef": "LEAD-1234",
    "amount": 500,
    "refundedAmount": 0,
    "providerCompanyId": null,
    "companyId": "2f3c1c0e-6a52-4a0f-9d34-6a7b3f6f2b10",
    "installments": 1,
    "paymentMethod": "PIX",
    "status": "WAITING_PAYMENT",
    "postbackUrl": "https://...",
    "metadata": null,
    "traceable": true,
    "secureId": null,
    "secureUrl": null,
    "pix": {
      "brcode": "00020126580014br.gov.bcb.pix...6304ABCD",
      "qrcode": "data:image/png;base64,iVBORw0KGgo...",
      "payloadBase64": "MDAwMjAxMjY1ODAwMTRici5nb3YuYmNiLnBpeC4uLg==",
      "imagemQrCodeInBase64": "iVBORw0KGgo...",
      "qrcodeBase64": "iVBORw0KGgo...",
      "txId": "6dcf2aee0d6148e1a12b78db78",
      "expiresAt": "2025-10-18T01:38:51.943+00:00"
    }
  },
  "status": 200,
  "message": "Transação criada e registrada com sucesso (OnlyUp)."
}

{
  "title": "amount inválido (centavos > 0)."
}

{
  "title": "Valor acima do limite permitido.",
  "detail": "O valor máximo por cobrança PIX é R$ 1,500.00.",
  "maxValueCents": 150000
}

{
  "title": "Somente PIX é suportado neste endpoint."
}

{
  "title": "Token de operação inválido.",
  "detail": "Token inválido ou expirado.",
  "header": "X-Operation-Token"
}

# 1. First, generate the operation token (optional step)
TOKEN=$(curl -s -X POST https://api.respawnpay.com/api/v1/operation-auth/token \
  -H "Content-Type: application/json" \
  -H "X-Client-Id: <CLIENT_ID>" \
  -H "X-API-Key: <API_KEY>" \
  -d '{"scopes": ["transaction:create"]}' | jq -r '.token')
# 2. Create the transaction with the token
curl -X POST https://api.respawnpay.com/api/v1/transactions/create \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Client-Id: <CLIENT_ID>" \
  -H "X-API-Key: <API_KEY>" \
  -H "X-Operation-Token: $TOKEN" \
  -H "Idempotency-Key: tx_$(date +%s)_$RANDOM" \
  -d '{
    "amount": 500,
    "currency": "BRL",
    "paymentMethod": "PIX",
    "installments": 1,
    "customer": {
      "id": "CUST-123",
      "name": "John",
      "email": "joao@ex.com",
      "document": {"number": "24577481600", "type": "CPF"},
      "phone": "11987654321"
    },
    "items": [{
      "title": "Produto X",
      "unitPrice": 500,
      "quantity": 1,
      "tangible": true
    }],
    "pix": { "expiresInDays": 1 },
    "postbackUrl": "",
    "traceable": true,
    "ip": "177.123.45.67"
  }'

// 1. Generate the operation token (optional step)
const tokenResponse = await fetch("https://api.respawnpay.com/api/v1/operation-auth/token", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Client-Id": "<CLIENT_ID>",
    "X-API-Key": "<API_KEY>"
  },
  body: JSON.stringify({
    scopes: ["transaction:create"],
    expiresInSeconds: 300
  })
});
const { token } = await tokenResponse.json();
// 2. Create the transaction with the token
const response = await fetch("https://api.respawnpay.com/api/v1/transactions/create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "X-Client-Id": "<CLIENT_ID>",
    "X-API-Key": "<API_KEY>",
    "X-Operation-Token": token,
    "Idempotency-Key": `tx_${Date.now()}_${Math.floor(Math.random()*1e6)}`
  },
  body: JSON.stringify({
    amount: 500,
    currency: "BRL",
    paymentMethod: "PIX",
    installments: 1,
    customer: {
      id: "CUST-123",
      name: "John",
      email: "joao@ex.com",
      document: { number: "24577481600", type: "CPF" },
      phone: "11987654321"
    },
    items: [{
      title: "Produto X",
      unitPrice: 500,
      quantity: 1,
      tangible: true
    }],
    pix: { expiresInDays: 1 },
    postbackUrl: "",
    traceable: true,
    ip: "177.123.45.67"
  })
});
const data = await response.json();
console.log(data);