Skip to main content
POST
/
transactions
curl --request POST \
  --url https://api.pluggoutech.com/api/transactions \
  --header 'Content-Type: application/json' \
  --header 'X-Public-Key: <api-key>' \
  --header 'X-Secret-Key: <api-key>' \
  --data '
{
  "payment_method": "pix",
  "amount": 10000,
  "buyer": {
    "buyer_name": "João da Silva",
    "buyer_document": "123.456.789-09",
    "buyer_phone": "11999999999"
  }
}
'
{
  "success": true,
  "message": "Pagamento criado com sucesso!",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "amount": 10000,
    "platform_tax": 149,
    "liquid_amount": 9851,
    "pix": {
      "emv": "00020126580014br.gov.bcb.pix0136..."
    }
  }
}

Authorizations

X-Public-Key
string
header
required

Sua chave pública de acesso à API. Ex: pk_live_abc123def456...

X-Secret-Key
string
header
required

Sua chave secreta de acesso à API. Ex: sk_live_xyz789ghi012...

Body

application/json
payment_method
enum<string>
required

Método de pagamento. Para cobranças PIX, envie sempre pix.

Available options:
pix
amount
integer
required

Valor da transação em centavos. Ex: para R$ 100,00 envie 10000. Mínimo: R$ 1,00 (100). Máximo: R$ 3.000,00 (300000). Após taxas, o valor líquido deve ser de no mínimo R$ 0,10.

Required range: x >= 100
Example:

10000

buyer
object
required

Dados do comprador.

acquirers
object[]

Até 3 adquirentes com prioridade para override nesta transação. Mutuamente exclusivo com acquirer_key. Adquirentes indisponíveis são ignoradas silenciosamente.

Maximum array length: 3
postback_url
string<uri>

URL opcional para receber notificação de postback desta transação.

metadata
object

Metadados opcionais em formato livre (objeto JSON).

Response

Transação criada com sucesso

success
boolean

Indica se a operação foi bem-sucedida.

message
string

Mensagem descritiva do resultado.

data
object