Skip to main content
POST
https://api.owem.com.br
/
v4
/
i
/
pix
/
in
/
refund
/
{endToEndId}
Refund PIX IN
curl --request POST \
  --url https://api.owem.com.br/v4/i/pix/in/refund/{endToEndId} \
  --header 'Authorization: <authorization>'
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "data": {
    "idempotencyKey": "debit:pix_in:refunded_processing:D123456789202512240000000000001",
    "type": "debit",
    "reason": "pix_in:refunded_processing",
    "status": "processing",
    "grossAmount": 100.0,
    "feeAmount": 0,
    "netAmount": 100.0,
    "endToEndId": "D123456789202512240000000000001",
    "parentEndToEndId": "E123456789202512230000000000001",
    "entryId": null,
    "accountId": "123456789012",
    "userId": "usr_abc123def",
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "createdAt": 1766523042000,
    "createdDate": "2025-12-24",
    "payer": {
      "ispb": "12345678",
      "personType": "company",
      "cpfCnpj": "XX123456000XXX",
      "name": "EXAMPLE COMPANY LTD",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "123456789012"
    },
    "receiver": {
      "ispb": "87654321",
      "personType": "person",
      "cpfCnpj": "XXX123456XX",
      "name": "JOHN DOE",
      "agency": "0001",
      "accountType": "CACC",
      "accountNumber": "00000000000012345678"
    }
  }
}

​
Purpose

Creates a refund for an already received PIX. The operation generates a Ledger entry and immediately returns the current processing status.

​
Authentication

​
Authorization
string
required
Basic Auth required in format: Basic {Base64(API_KEY:API_SECRET)}

​
Path Parameters

​
endToEndId
string
required
E2E of the original PIX IN to be refunded.

​
Response

​
requestId
string
UUID for tracking
​
success
boolean
Operation status
​
size
number
Number of returned items
​
data
object
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "data": {
    "idempotencyKey": "debit:pix_in:refunded_processing:D123456789202512240000000000001",
    "type": "debit",
    "reason": "pix_in:refunded_processing",
    "status": "processing",
    "grossAmount": 100.0,
    "feeAmount": 0,
    "netAmount": 100.0,
    "endToEndId": "D123456789202512240000000000001",
    "parentEndToEndId": "E123456789202512230000000000001",
    "entryId": null,
    "accountId": "123456789012",
    "userId": "usr_abc123def",
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "createdAt": 1766523042000,
    "createdDate": "2025-12-24",
    "payer": {
      "ispb": "12345678",
      "personType": "company",
      "cpfCnpj": "XX123456000XXX",
      "name": "EXAMPLE COMPANY LTD",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "123456789012"
    },
    "receiver": {
      "ispb": "87654321",
      "personType": "person",
      "cpfCnpj": "XXX123456XX",
      "name": "JOHN DOE",
      "agency": "0001",
      "accountType": "CACC",
      "accountNumber": "00000000000012345678"
    }
  }
}

​
Status Codes

HTTPDescription
200Refund accepted/registered
400Malformed endToEndId
401Invalid credentials
403IP not allowlisted
404Original PIX not found
409Refund already requested or conflict
422Not refundable (arrangement/bank rules)
429Rate limit exceeded
500Internal error

​
Refund Status

StatusDescription
processingRefund registered, in settlement
succeededRefund confirmed
failedRefund not completed
Track the outcome via Ledger: GET /v4/i/ledger/end-to-end/:endToEndId (using the refund E2E).
The parentEndToEndId references the original PIX IN being refunded.