Get Pay-in Status (Brazil PIX)

GET/v1/payins/:id

Poll pay-in status after Create Pay-in. This is the shared status endpoint for all rails — use the transactionId from the Brazil create response. There is no request body.

Path parameters

Field	Type	Required	Description
`id`	`string`	Yes	Use `transactionId` from the create response

Example

cURL

curl -X GET https://api.transacty.ai/v1/payins/{transactionId} \
  -H "X-Transacty-Key: $TRANSACTY_KEY" \
  -H "X-Transacty-Timestamp: $TS" \
  -H "X-Transacty-Signature: $SIG" \
  -H "Content-Type: application/json"

Success


{
  "id": "f7c2f6d1-96df-4980-a514-7854726f52a0",
  "transactionId": "f7c2f6d1-96df-4980-a514-7854726f52a0",
  "status": "success",
  "amount": "100.00",
  "paidAmount": "100.00",
  "platformOrderId": "2026062907000000018",
  "paymentMethod": "PIX",
  "createdAt": "2026-06-29T11:20:54.263Z",
  "completedAt": "2026-06-29T11:21:59.798Z",
  "currency": "BRL",
  "fees": {
    "platformFee": "2.00",
    "feeType": "payin",
    "feeStatus": "applied"
  },
  "netAmount": "98.00",
  "totalWalletDebit": null
}

Pending


{
  "id": "f7c2f6d1-96df-4980-a514-7854726f52a0",
  "transactionId": "f7c2f6d1-96df-4980-a514-7854726f52a0",
  "status": "pending",
  "amount": "100.00",
  "paidAmount": null,
  "platformOrderId": "2026062907000000018",
  "paymentMethod": "PIX",
  "createdAt": "2026-06-29T11:20:54.263Z",
  "completedAt": null,
  "currency": "BRL",
  "fees": {
    "platformFee": "2.00",
    "feeType": "payin",
    "feeStatus": "estimated"
  },
  "netAmount": "98.00",
  "totalWalletDebit": null
}

Response fields

Field	Type	Description
`id`	`string`	Internal id (same as `transactionId`)
`transactionId`	`string`	Public transaction id
`status`	`string`	`pending`, `success`, or `failed`
`amount`	`string`	Requested pay-in amount
`paidAmount`	`string \| null`	Amount the customer paid; set on `success`
`currency`	`string`	`BRL`
`platformOrderId`	`string`	Provider-side order reference
`paymentMethod`	`string`	`PIX`
`createdAt`	`string` (ISO datetime)	Creation timestamp
`completedAt`	`string \| null` (ISO datetime)	Completion timestamp; `null` while pending
`fees`	`object`	Transacty service fee
`fees.platformFee`	`string`	Service fee amount
`fees.feeType`	`string`	`payin`
`fees.feeStatus`	`string`	`estimated` while pending; `applied` on success
`netAmount`	`string`	BRL credited to your wallet after the fee
`totalWalletDebit`	`string \| null`	`null` on pay-in

Reconcile on the webhook (payin.completed) or by polling until status === "success". Brazil transactions also appear on GET /v1/transactions with rail: "brazil".