Inovpay-API
  1. Transações
Inovpay-API
  • Comece Por Aqui
  • Autenticação
    • Gerar Token
      POST
  • Estabelecimentos
    • Criar Estabelecimento
      POST
    • Listar Estabelecimentos
      GET
    • Listar Estabelecimento ID
      GET
  • Transações
    • Criar Transação Crédito
      POST
    • Criar Transação PIX
      POST
    • Listar Transações
      GET
    • Lista Transação ID
      GET
    • QR Code PIX
      GET
    • Simulate Transações
      POST
  • Antifraude
    • Antifraude 3DS
  1. Transações

Criar Transação PIX

POST
/v1/marketplace/transactions
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/marketplace/transactions' \
--header 'integration-key: {{integration-key}}' \
--header 'x-token: {{x-token}}' \
--header 'Authorization: {{bearer_token}}' \
--header 'establishment_id: {{establishment_id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payment_type": "PIX",
    "amount": 201,
    "interest": "CLIENT",
    "client": {
        "first_name": "João",
        "last_name": "da Silva",
        "document": "10068114001",
        "phone": "31992831122",
        "email": "emaildocliente@gmail.com"
    }
}'
Response Response Example
{
    "_id": "682b9f60852681ae93d23dd6",
    "status": "PENDING",
    "amount": 201,
    "original_amount": 203,
    "fees": 2,
    "type": "PIX",
    "gateway_key": "bf79554e-2f4b-4eba-8b8e-9964842e1143",
    "gateway_authorization": "INOVPAY",
    "card": null,
    "customer": {
        "first_name": "João",
        "last_name": "da Silva",
        "document": "10068114001",
        "phone": "31992831122",
        "email": "emaildocliente@gmail.com",
        "_id": "682b9f60852681ae93d23dc4"
    },
    "point_of_sale": {
        "type": "ONLINE",
        "identification_type": "API"
    },
    "acquirer": {
        "name": "ITAU",
        "key": "60701190000104",
        "gateway_key": "bf79554e-2f4b-4eba-8b8e-9964842e1143",
        "_id": "682b9f60852681ae93d23de5"
    },
    "expected_on": [
        {
            "date": "2025-05-20T12:00:00.327Z",
            "amount": 201,
            "status": "PENDING",
            "installment": 1
        }
    ],
    "emv": "00020101021226910014BR.GOV.BCB.PIX2569spi-h.itau.com.br/pix/qr/v2/af581bdc-624e-4333-af38-1adaddfa6ce05204000053039865802BR5914PMD BASHAR RIO6009SAO PAULO62070503***6304E7DB",
    "antifraud": [
        {
            "analyse_status": "NO_ANALYSED",
            "_id": "682b9f60852681ae93d23dd4",
            "session": null
        }
    ],
    "created_at": "2025-05-19T21:15:12.331Z"
}

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header
integration-key
string 
requerido
Exemplo:
{{integration-key}}
x-token
string 
requerido
Exemplo:
{{x-token}}
Authorization
string 
requerido
Exemplo:
{{bearer_token}}
establishment_id
string 
requerido
Exemplo:
{{establishment_id}}
Parâmetros Bodyapplication/json
payment_type
string 
requerido
amount
integer 
requerido
interest
string 
requerido
client
object 
requerido
first_name
string 
requerido
last_name
string 
requerido
document
string 
requerido
phone
string 
requerido
email
string 
requerido
Examples

Respostas

🟢201Criado
application/json
Body
_id
string 
requerido
status
string 
requerido
amount
integer 
requerido
original_amount
integer 
requerido
fees
integer 
requerido
type
string 
requerido
gateway_key
string 
requerido
gateway_authorization
string 
requerido
card
null 
requerido
customer
object 
requerido
first_name
string 
requerido
last_name
string 
requerido
document
string 
requerido
phone
string 
requerido
email
string 
requerido
_id
string 
requerido
point_of_sale
object 
requerido
type
string 
requerido
identification_type
string 
requerido
acquirer
object 
requerido
name
string 
requerido
key
string 
requerido
gateway_key
string 
requerido
_id
string 
requerido
expected_on
array [object {4}] 
requerido
date
string 
opcional
amount
integer 
opcional
status
string 
opcional
installment
integer 
opcional
emv
string 
requerido
antifraud
array [object {3}] 
requerido
analyse_status
string 
opcional
_id
string 
opcional
session
null 
opcional
created_at
string 
requerido
Página anterior
Criar Transação Crédito
Próxima página
Listar Transações
Built with