Aukro WebAPI

doGetMyIncomingPayments

This method allows you to retrieve a list of completed payments made by buyers via PayU for transactions concluded within 90 days. In case the time range is not set, a list of payments made within a week (25 items) is retrieved and sorted in a descending order by their completion time. Available filters:: buyerId - user making the payment itemId - offer related to the payment transRecvDateFrom/transRecvDateTo - time range to filter the payments Different filters can be combined. If an incorrect user’s identifier is transferred, an empty structure is returned. The strictedSearch field allows you to filter data by date. If you provide 0 or the field is not transferred at all (optional parameter with a default 0 value), the filter will work as follows: If a particular value is provided in transRecvDateFrom, but 0 is provided in transRecvDateTo: transRecvDateFrom will be set to the provided date starting at 0:00, e.g. if you enter timestamp=1462486320 (05.05.2016 22:12:00), the system will change it to 1462406400 (05.05.2016 00:00:00) transRecvDateTo will be calculated in the following manner and the lower value will be applied: date provided in transRecvDateFrom + 7 days (1463011200 - 12.05.2016 00:00:00) the day following the date provided in transRecvDateFrom (1462492800 - 06.05.2016 00:00:00); in this example the transRecvDateTo value will be set to 1462492800. In an opposite case, if 0 is provided in transRecvDateFrom, but a particular value is provided in transRecvDateTo: transRecvDateTo will be set to the provided date + 1 starting at 0:00, e.g. if you enter timestamp=1462536000 (06.05.2016 12:00:00), the system will change it to 1462579200 (07.05.2016 00:00:00) transRecvDateFrom will be calculated in the following manner and the higher value will be applied: zero (0) transRecvDateTo - 7 days (1461974400 - 30.04.2016 00:00:00), which means that in this case transRecvDateFrom will be set to 1461974400 Provide particular values in start date, e.g. 1462486320 (05.05.2016 22:12:00) and in end date, e.g. 1462536000 (06.05.2016 22:12:00) to receive a list of payments processed in that period: transRecvDateFrom will be set to 1462406400 (05.05.2016 00:00:00) transRecvDateTo will be set to 1462579200 (07.05.2016 00:00:00) If the strictedSearch field transfers 1, the filter will work as follows: When a particular value is provided as the start date (transRecvDateFrom) and 0 as the end date (transRecvDateTo), a list of payments made between start date and 7 following days will be returned. In an opposite case, (when 0 is provided as the start day, but the end date has a particular value) a list of payments made between end date and 7 preceding days will be returned. Provide particular values for both start and end date to receive a list of payments processed in a given period.

  1. sessionHandle | String | required
    User's session identifier received using the doLogin(Enc) method.
  2. buyerId | Integer
    Identifier of a buyer whose payments are to be loaded.
  3. itemId | Long
    Identifier of an offer related to the payment (also when an offer is a part of a combined payment).
  4. transRecvDateFrom | Long
    Start date of time range (in the Unix time format) to load a list of payments.
  5. transRecvDateTo | Long
    End date of time range (in the Unix time format) to load a list of payments.
  6. transPageLimit | Integer
    Size of data portion (range 1-25; default value: 25).
  7. transOffset | Integer
    Controlling (through the incrementation of provided value) the process of loading new data portions (portion numbers are indexed from 0).
  8. strictedSearch | Integer
    Precise (up to seconds) search operation based on data provided in transRecvDateFrom and transRecvDateTo (0 - no, 1 - yes).
  1. payTransIncome | UserIncomingPaymentStruct[]
    Array of structures containing information on payments of users.
    1. payTransId | Long
      Transaction identifier.
    2. payTransItId | Long
      Offer identifier (or 0 for combined payments for which information on particular offers are in the payTransDetails structure).
    3. payTransBuyerId | Integer
      Buyer's identifier.
    4. payTransType | String | required
      Payment method (mBank, Multibank, BZ WBK, Pekao SA, BPH, Inteligo, Nordea, iPKO BP, ING, Raiffeisen Bank, Millennium, Kredyt Bank, Polbank, Citi Handlowy, Deutsche Bank, Getin Bank, invest-bank, Meritum Bank, Eurobank, Alior Bank, BGŻ, Payment card, Bank transfer, Standard transfer (outside PayU system), COD).
    5. payTransStatus | String | required
      PayU transaction status.
    6. payTransAmount | BigDecimal | required
      Amount of payment from a user.
    7. payTransCreateDate | Long
      Date of creating PayU transaction (in the Unix time format).
    8. payTransRecvDate | Long
      Date of completing PayU transaction (in the Unix time format).
    9. payTransPrice | BigDecimal | required
      Value of items bought within the offer (or offers for combined payments) and paid via the given PayU transaction (or 0 in case of an additional payment).
    10. payTransCount | Integer
      Number of items bought within the offer and paid via the given PayU transaction (or 0 in case of a combined payment or an additional payment).
    11. payTransPostageAmount | BigDecimal | required
      Total cost of delivery method selected by a user, paid via PayU (or 0 in case of an additional payment).
    12. payTransDetails | PaymentDetailsStruct[]
      Array of structures containing information on offers forming the combined payment.
      1. payTransDetailsItId | Long
        Offer identifier.
      2. payTransDetailsPrice | BigDecimal | required
        Value of item bought within the offer and paid via the given PayU transaction.
      3. payTransDetailsCount | Integer
        Number of items bought within the offer and paid via the given PayU transaction.
    13. payTransIncomplete | Integer
      Information on payment completion (1 - incomplete payment, 0 - complete payment).
    14. payTransMainId | Long
  • ERR_INPUT_DATE_RANGE
    Incorrect range of dates (the range between start and end date exceeds 90 days, end date equals or precedes start date or provided values are lower than 0).
  • ERR_INCORRECT_BUYER_ID
    Invalid (< 0) buyer's identifier.
  • ERR_INVALID_ITEM_ID
    Invalid (< 0) offer identifier or no offer with such identifier.
  • ERR_INCORRECT_PAGE_NUMBER
    Problems with Allegro database.
  • ERR_NEW_PAYMENT_INTERNAL_ERROR
    Problems with Allegro database.
  • ERR_NO_SESSION / ERR_SESSION_EXPIRED
    Invalid session identifier or the session has expired.
  • ERR_WEBAPI_KEY_INACTIVE
    WebAPI key used to generate the session has been deactivated (the key owner has not accepted WebAPI User Agreement).
  • ERR_YOU_NOT_SOLD_THIS_ITEM
    The logged-in user was not a seller in this offer.