Skip to main content
POST
/
payin
Criar Payin
curl --request POST \
  --url https://api.legacyecom.com.br/payin \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentMethod": "<string>",
  "amount": 123,
  "referenceId": "<string>",
  "webhookUrl": "<string>",
  "isPhysicalProduct": true,
  "payerIp": "<string>",
  "customer": {
    "name": "<string>",
    "document": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "address": {
      "street": "<string>",
      "number": "<string>",
      "complement": "<string>",
      "zipCode": "<string>",
      "city": "<string>",
      "state": "<string>"
    }
  },
  "items": [
    {
      "title": "<string>",
      "quantity": 123,
      "unitPrice": 123,
      "description": "<string>"
    }
  ],
  "card": {
    "holderName": "<string>",
    "number": "<string>",
    "expirationMonth": "<string>",
    "expirationYear": "<string>",
    "cvv": "<string>",
    "installments": 123,
    "threeDSecure": {}
  }
}
'

​
Autorização

Você deve obrigatoriamente fornecer sua credencial no cabeçalho.
​
Authorization
string
required
Use o Basic Auth base64 de suas chaves de produção. Ex: Basic cGtf...

​
Body

​
paymentMethod
string
required
Os valores aceitos são: "CREDIT_CARD", "PIX" ou "BOLETO"
​
amount
integer
required
Valor total da transação em centavos. Exemplo: para R$100,00 envie 10000
​
referenceId
string
required
ID único ou número do pedido dentro do banco de dados da sua aplicação associada à cobrança.
​
webhookUrl
string
Opcional. Uma URL do seu backend (https://...) que deverá ser notificada quando o status deste pagamento mudar (Ex: o Pix for pago).
​
isPhysicalProduct
boolean
required
Indica se o item cobrado exige entrega física (true) ou se é digital ou serviço (false).
​
payerIp
string
required
Endereço de IPv4 de quem está efetuando o pagamento originário (Necessário para a prevenção de Fraudes e Anti-Chargeback).

​
Customer (Cliente)

Objeto encapsulando quem está comprando de você.
​
customer
object
required

​
Items (Carrinho)

Array de objetos especificando o que está sendo comprado e taxado.
​
items
array
required

​
Card (Cartão de Crédito)

Se o paymentMethod escolhido foi "CREDIT_CARD", as propriedades do cartão são obrigatórias. Para as formas PIX e Boleto, omitir este objeto por inteiro.
​
card
object

​
Response

A resposta varia ligeiramente dependendo do método de pagamento escolhido. A API sempre tentará devolver um 201 Created.

​
Sucesso: Criação de PIX

{
  "id": "payin_12345",
  "externalId": "tx_998877",
  "referenceId": "meu-pedido-1234",
  "status": "PENDING",
  "amount": 10000,
  "paymentMethod": "PIX",
  "createdAt": "2026-03-02T12:00:00.000Z",
  "pix": {
    "qrcode": "00020101021126360014br.gov.bcb.pix0114+5511999999999520400005303986540510.0058..."
  }
}

​
Sucesso: Criação de Boleto

{
  "id": "payin_12346",
  "externalId": "tx_998878",
  "referenceId": "meu-pedido-1235",
  "status": "PENDING",
  "amount": 10000,
  "paymentMethod": "BOLETO",
  "createdAt": "2026-03-02T12:05:00.000Z",
  "boleto": {
    "barcode": "34191.09008 00000.000004 00000.000006 1 800000000010000",
    "url": "https://adquirente.legacyecom.com.br/boleto/12346"
  }
}

​
Sucesso: Cartão de Crédito

{
  "id": "payin_12347",
  "externalId": "tx_998879",
  "referenceId": "meu-pedido-1236",
  "status": "APPROVED",
  "amount": 10000,
  "paymentMethod": "CREDIT_CARD",
  "createdAt": "2026-03-02T12:10:00.000Z"
}