Criação de Invoices

POST

/api/v2/invoices

Use este endpoint para criar uma cobrança imediata para uma invoice, permitindo que o cliente pague via PIX ou cartão de crédito.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200Sucesso

application/json

Body

🟠401Auth Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.oironbank.com/api/v2/invoices' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "method": "string",
  "product_fisical": "string",
  "ip_payer": "string",
  "total_price_cents": 0,
  "postback_url": "string",
  "payer": {
    "name": "string",
    "cpf_cnpj": "string",
    "email": "string",
    "phone": "string",
    "address_zip": "string",
    "address_line": "string",
    "address_number": "string",
    "address_complement": "string",
    "address_city": "string",
    "address_state": "string"
  },
  "card": {
    "token": "string",
    "installment": 0,
    "number": "string",
    "first_name": "string",
    "last_name": "string",
    "month": "string",
    "year": "string",
    "security_code": "string",
    "cavv": "string",
    "xid": "string",
    "eci": "string",
    "version": "string",
    "referenceid": "string"
  },
  "items": [
    {
      "name": "string",
      "description": "string",
      "quantity": 0,
      "unit_price": 0
    }
  ]
}'

Response Example

200 - Exemplo - Pix

{
    "data": {
        "invoice_id": "c7b8d123-45ef-67a9-80bc-9123def45678",
        "order_code": "a1f2b3c4-d5e6-7890-ab12-cd34ef56gh78",
        "qr_code_pix": "00020101021226910014br.gov.bcb.pix2569qrcode.pix.exemplo.com.br/pixqrcode/v2/123abc456def789ghi000053039865802BR5908TechPayLTDA6009Curitiba62070503***6304A12B",
        "status": "pending",
        "total_cents": 2599
    },
    "message": "Fatura criada com sucesso"
}

Modificado em 2025-10-30 13:06:15

Página anterior

3DS e Tokenização de Cartões

Próxima página

Buscar Transações