getPayInTransactions

List incoming payment transactions (money received from customers).

Request

POST /api/v2/getPayInTransactions

Headers

Header	Required	Description
token	Yes	Your API Key
Content-Type	Yes	application/json

Body Parameters

Field	Type	Required	Default	Description
page	integer	No	1	Page number
limit	integer	No	200	Maximum results (max: 1000)
search	string	No	—	Search by recipient_note, amount, transaction_id, or payment_method
date	string	No	—	Filter by specific date (YYYY-MM-DD)
since	integer	No	0	Show transactions from the last N days
pay_id	integer	No	—	Get a specific transaction by pay_id

Response

Success

{
  "data": [
    {
      "pay_id": "99296",
      "creator_id": "8654bacd-3d54-4010-069f-3fd9f4436b2",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "amount": "88.19",
      "net_amount": "84.71",
      "service_fee": "1.33",
      "service_fee_psp": "3.15",
      "status": "Success",
      "recipient_note": "Order TEST2026013557",
      "payout_status": "Pending",
      "created_at": "2026-05-20 18:56:08",
      "is_split_link": "false",
      "is_dispute": "false",
      "is_refund": "false",
      "payment_method": null,
      "transaction_type": "Basic"
    },
    {
      "pay_id": "99298",
      "creator_id": "8654bacd-3d54-4010-069f-3fd9f4436b2",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "amount": "55.25",
      "net_amount": "53.13",
      "service_fee": "0.83",
      "service_fee_psp": "1.29",
      "status": "Success",
      "recipient_note": "Payment for Order #CNF-177930606093050",
      "payout_status": "Pending",
      "created_at": "2026-05-20 10:19:34",
      "is_split_link": "true",
      "is_dispute": "false",
      "is_refund": "false",
      "payment_method": null,
      "transaction_type": "Split"
    }
  ],
  "ResponseCode": 1,
  "ResponseMsg": "List retrived successfully",
  "Result": "True",
  "ServerTime": "CEST"
}

Response Fields (per item)

Field	Type	Description
pay_id	string	Payment link ID
creator_id	string	Internal user ID of the link creator
user_id	string	Internal user ID of the recipient (you)
amount	string	Your gross share of the payment
net_amount	string	Amount after all fees
service_fee	string	Platform fee (SecPaid)
service_fee_psp	string	PSP fee (payment processing)
status	string	"Success"
recipient_note	string	Note set during link creation
payout_status	string	"Pending", "InProgress", or "Approved"
created_at	string	When the payment was completed
is_split_link	string	"true" / "false"
is_dispute	string	Whether the payment is disputed
is_refund	string	Whether this is a refund
payment_method	string	The payment method used (e.g. null for card, "Bank Transfer" for bank transfer)
transaction_type	string	"Basic" or "Split"

Examples

cURLJavaScriptPHP

curl -X POST https://app.secpaid.com/api/v2/getPayInTransactions \
  -H "Content-Type: application/json" \
  -H "token: YOUR_API_KEY" \
  -d '{"limit": 50, "since": 30}'

const response = await fetch("https://app.secpaid.com/api/v2/getPayInTransactions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "token": "YOUR_API_KEY"
  },
  body: JSON.stringify({ limit: 50, since: 30 })
});

$response = Http::withHeaders([
    'token' => 'YOUR_API_KEY',
])->post('https://app.secpaid.com/api/v2/getPayInTransactions', [
    'limit' => 50,
    'since' => 30,
]);

Filtering

• date: Exact date match (format: YYYY-MM-DD)
• since: Relative filter — last N days from today
• pay_id: Get a single specific transaction
• search: Partial text match on recipient_note

These filters can be combined. If multiple are provided, they are applied together (AND logic).

Notes

• Returns only successful transactions where you are the recipient
• For split links, amount shows your share (not the total payment)
• payout_status tracks the payout lifecycle: "Pending" → "InProgress" → "Approved"
• payment_method is null for card payments or "Bank Transfer" for bank transfers
• transaction_type is "Basic" for regular links or "Split" for split payment links
• Refund entries appear as negative amounts with is_refund: "true"
• Results ordered by created_at descending (newest first)