Search pay-in transactions
Production
https://api.paypaga.com
Production
https://api.paypaga.com
GET
/v2/transactions/pay-in
Use this endpoint to query Pay In transactions data for custom reports or reconciliation purposes.
Transaction statuses
| Status | Description | Final |
|---|---|---|
| initiated | The transaction has been initiated | No |
| created | The transaction has been created and is ready to send to partner | No |
| pending | The transaction has been sent to a partner, and is awaiting confirmation of payment | No |
| approved | The transaction has been confirmed by the partner | Yes |
| expired | A pay-in transaction hasn't been paid in the allowed amount of time | Yes, unless a late payment is received — see note below |
| failed | An error occurred while sending the transaction to a partner | Yes |
| refunded | The transaction has been refunded | Yes |
| rejected | The transaction has been rejected by a partner | Yes |
Error codes for Query Pay-in Transactions
| HTTP status | Error code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Request validation failed |
| 401 | UNAUTHORIZED | Missing or invalid authorization token |
| 403 | FORBIDDEN | You do not have permission to access this resource |
| 500 | INTERNAL_ERROR | Unexpected server error |
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in?lookup=&merchant_order_reference=&country=¤cy=&payment_method=&status=&date_from=&date_to=&page=&page_size='Response Response Example
200 - Example 1
{
"items": [
{
"approved_on": "2024-08-06T20:12:41Z",
"country": "BR",
"created_on": "2024-08-06T20:05:41Z",
"currency": "BRL",
"expired_on": "2024-08-08T12:00:00Z",
"expires_at": "2024-08-06T22:10:41Z",
"fail_reason": "Insufficient funds",
"failed_on": "2024-08-06T20:10:41Z",
"fee": 1.5,
"initiated_on": "2024-08-06T20:05:40Z",
"merchant_order_reference": "ORDER-2026-0001",
"merchant_transaction_reference": "TRX-2026-0001",
"paid_amount": 90,
"payment_method": "top_up",
"processing_output": {
"customer_name": "João Silva",
"document_number": "12345678901"
},
"refund_reason": "Customer requested refund",
"refunded_on": "2024-08-07T15:30:00Z",
"requested_amount": 100,
"status": "initiated",
"tax": 0.5,
"transaction_amount": 98,
"transaction_id": "20240806-2010-4086-8342-c28f4979f834",
"transaction_input": {
"payer_document": "12345678901",
"payer_name": "João Silva"
},
"unsolicited_payment": false
}
],
"meta": {
"page": 1,
"page_size": 25,
"total_items": 200
}
}Modified at 2026-09-11 10:06:04