Skip to content

Transactions Documentation

General Information

  • Transaction/Payment Objects are created upon link payment success or refund/dispute event
  • You can fetch your your payments status via v2 API at the moment.

Example Request

    curl --location 'https://app.dev.secpaid.com/api/v2/getPayInTransactions' \
    --header 'token: API-Key' \
    --form 'limit="10000"' \
    --form 'since="20"' \
    --form 'date="2024-12-17"' \
    --form 'pay_id="44116"'

Example Response

json { "data": [ { "pay_id": "42011", "user_id": "a95a452a-2c74-465c-b63b-81d73a7a755d", "transaction_id": "20241026-pi-QRxbbs7z9n", "amount": "1.00", "net_amount": "0.83", "service_fee": "-0.10", "service_fee_psp": "0.27", "status": "Success", "recipient_note": "api token test", "payout_status": "Pending", "created_at": "2024-10-26 16:18:20", "is_split_link": "false", "transaction_type": "Basic" } ], "totalRecords": 7, "expected_payout": "4.02", "ResponseCode": 1, "ResponseMsg": "List retrieved successfully", "Result": "True", "ServerTime": "CEST" }

Key Fields

  • pay_id: Unique payment identifier
  • user_id: User who created the payment link
  • transaction_id: Unique transaction identifier
  • amount: Total transaction amount
  • net_amount: Amount after fees
  • service_fee: SecPaid's fee
  • service_fee_psp: Payment Service Provider's fee
  • status: Transaction status
  • recipient_note: Note from recipient
  • payout_status: Payout status
  • created_at: Transaction creation timestamp
  • is_split_link: Indicates if it's a split payment
  • transaction_type: Type of transaction
  • date: Date of the Payment
  • limit: limit count of the received payment list
  • since: payments since this day

Important Notes

  • Multiple transactions are returned in the data array
  • totalRecords shows the number of transactions returned
  • expected_payout is the total amount expected to be paid out
  • Always check ResponseCode and Result for successful retrieval