Skip to main content
GET
/
v1
/
payouts
/
payment-batches
/
{id}
Consultar repasse pelo ID
curl --request GET \
  --url https://api.malga.io/v1/payouts/payment-batches/{id} \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Client-Id: <api-key>'
{
  "id": "9b1a3a3e-2f87-4b2f-ae59-1234567890ab",
  "createdAt": "2026-04-25T18:00:00.000Z",
  "updatedAt": "2026-04-25T18:00:00.000Z",
  "amount": 250000,
  "feeAmount": 5000,
  "totalFeeAmount": 7500,
  "balanceAmount": 0,
  "creditAmount": 0,
  "refundAmount": 0,
  "debitAdjustmentAmount": 0,
  "creditAdjustmentAmount": 0,
  "finalBalance": 242500,
  "withdrawalFeeAmount": 0,
  "reportUrl": null,
  "paymentDate": "2026-04-28",
  "payoutDate": "2026-04-28",
  "status": "paid",
  "feature": "subacquirer",
  "paymentMethod": "credit",
  "paymentArrangement": "VCC",
  "error": null
}

Authorizations

​
X-Client-Id
string
header
required
​
X-Api-Key
string
header
required

Path Parameters

​
id
string<uuid>
required

Identificador do repasse

Query Parameters

​
sellerId
string<uuid>

Filtra o repasse por seller

Response

Detalhes do repasse

​
id
string<uuid>

Identificador único do repasse

​
createdAt
string<date-time>

Data de criação do repasse em RFC 3339

​
updatedAt
string<date-time>

Data da última atualização do repasse em RFC 3339

​
amount
integer

Valor bruto do repasse em centavos

​
feeAmount
integer

Total de taxas do provedor aplicadas em centavos

​
totalFeeAmount
integer

Total geral de taxas aplicadas em centavos

​
balanceAmount
integer

Saldo negativo remanescente em centavos que foi compensado neste repasse

​
creditAmount
integer

Total de créditos manuais aplicados em centavos

​
refundAmount
integer

Total de estornos descontados do repasse, em centavos

​
debitAdjustmentAmount
integer

Total de ajustes a débito aplicados em centavos

​
creditAdjustmentAmount
integer

Total de ajustes a crédito aplicados em centavos

​
finalBalance
integer

Saldo final liquidado para o cliente, em centavos

​
withdrawalFeeAmount
integer

Tarifa de saque/transferência aplicada em centavos

​
reportUrl
string | null

URL do relatório detalhado do repasse, quando disponível

​
paymentDate
string<date>

Data programada para liquidação do repasse no formato YYYY-MM-DD

​
payoutDate
string<date> | null

Data efetiva em que o repasse foi pago no formato YYYY-MM-DD

​
status
enum<string>

Status atual do repasse:

  • pending: aguardando processamento
  • paid: liquidado com sucesso
  • failed: falhou no processamento
  • offset: compensado com saldo de outro repasse
Available options:
pending,
paid,
failed,
offset
​
feature
enum<string>

Tipo de operação que originou o repasse

Available options:
subacquirer,
nupay,
general
​
paymentMethod
enum<string> | null

Meio de pagamento das ordens que compõem o repasse

Available options:
credit,
pix,
nupay
​
paymentArrangement
string | null

Arranjo de pagamento associado

​
error
object

Detalhe do erro, presente quando o repasse está em status failed