Skip to main content
GET
/
sellers
/
pix
/
{id}
Consultar cobranca PIX
curl --request GET \
  --url http://localhost:3030/sellers/pix/{id} \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'
{
  "id": "<string>",
  "status": "<string>",
  "amountCents": 123,
  "pix": {
    "qrCode": "<string>",
    "copyPaste": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "splits": [
    {
      "id": "<string>",
      "merchantId": "<string>",
      "amountCents": 123,
      "percentage": 123
    }
  ],
  "webhook": {
    "url": "<string>",
    "secret": "<string>",
    "events": [
      "<string>"
    ]
  },
  "updatedAt": "2023-11-07T05:31:56Z"
}

​
Caso de uso

Use esta rota para consultar o estado de uma cobranca ja criada e sincronizar seu ERP, checkout ou painel financeiro.

​
Autenticacao

  • x-client-id
  • x-client-secret

​
Pre-condicoes e requisitos

  • O id deve ser o identificador retornado na criacao da cobranca.
  • A cobranca precisa pertencer ao merchant autenticado.

​
Request

Parametro principal:
  • id (path): identificador da cobranca PIX.

​
Response de sucesso

Em 200, a API retorna:
  • id, status, amountCents, description
  • pix.qrCode, pix.copyPaste, pix.expiresAt
  • splits (quando houver)
  • createdAt e updatedAt

​
Erros comuns reais

HTTPcodeQuando ocorre
400MERCHANT_ID_REQUIREDMerchant nao resolvido na credencial.
401CREDENTIALS_REQUIREDCredenciais ausentes.
401INVALID_CREDENTIALSCredenciais invalidas.
404NOT_FOUNDCobranca inexistente para o merchant autenticado.

​
Regras de negocio e observacoes operacionais

  • A consulta retorna somente cobrancas do merchant autenticado.
  • Para conciliacao, persista id, status, externalRef e timestamps.
  • Alias legado /rifeiro/pix/:id existe por compatibilidade; use /sellers/pix/{id} como caminho principal.

​
Exemplo de codigo

curl --request GET \
  --url https://api.turbofypay.com/sellers/pix/3f8d6f3a-87f9-4ed4-a820-95f76f050fca \
  --header "x-client-id: <client-id>" \
  --header "x-client-secret: <client-secret>"

​
Proximos passos

  1. Se ainda nao criou a cobranca, use Criar cobranca PIX.
  2. Para eventos assincronos, configure Webhooks.

Authorizations

​
x-client-id
string
header
required

Client ID fornecido pela TurbofyPay.

​
x-client-secret
string
header
required

Client Secret fornecido pela TurbofyPay.

Headers

​
x-client-id
string
required

Identificador do integrador.

​
x-client-secret
string
required

Segredo de autenticacao do integrador.

Path Parameters

​
id
string
required

Response

Cobranca PIX encontrada.

​
id
string
required
​
status
string
required
​
amountCents
integer
required
​
pix
object
required
​
createdAt
string<date-time>
required
​
description
string | null
​
splits
object[]
​
webhook
object
​
updatedAt
string<date-time>
Last modified on April 13, 2026