Transactions API

Transactions API is an API which provides a list of all user's gameplay transactions, including their status and unique transaction IDs, which are crucial for processing transactions as well as troubleshooting any issues during gameplays.

Get user's gameplay transactions


POST /operator/generic/v2/transactions/list HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "start_time": "2017-11-05T20:15:30",
  "end_time": "2017-11-06T20:15:30",
  "operator_id": 1
}

Provides a list of a gameplay transactions.

Header parameters

  • uX-Nirova-Signature - any · required

    • RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

  • user - string · optional

  • sub_partner_id - string · optional

    • ID of Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

    • Example: my-platform-id

  • start_time - string · ISO-8601 · required

    • The date and time combination in ISO 8601 Extended format (YYYY-MM-DDThh:mm:ss).

    • Example: 2017-11-05T13:15:30

  • operator_id - integer · required

    • Unique identifier for the Operator in Nirova system. Used to authorize incoming requests. You can obtain your operator_id from the Nirova BackOffice after your Operator entity is registered and set up in the Nirova system by the internal teams.

    • Example: 1

  • end_time - string · ISO-8601 · required

    • The date and time combination in ISO 8601 Extended format (YYYY-MM-DDThh:mm:ss).

    • Example: 2017-11-05T13:15:30

  • currency - string · enum · required

    • The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

    • Example: EUR

    • Available options: BSD, TTD, ZMW, BMD, USD, BYR, UGX, HKD, MGA, GIP, UZS, MKD, PTS, mLTC, EGP, AWG, CZK, ILS, MZN, TND, XPF, SOS, DOP, RUB, KRW, BTN, KGS, BAM, AOA, SOC, AMS, BND, RSD, FKP, PEN, EOS, GHS, JPY, TRY, SBD, UAH, LTL, FJD, GNF, MDL, AFN, ZAR, MOP, TJS, BOB, JMD, QAR, IRR, SYP, XXX, NAD, MYR, CUP, NOK, BGN, KPW, MNT, NZD, uETH, SGD, PYG, OMR, DZD, EUR, TMT, MMK, PTQ, ANG, TZS, CRC, CVE, SET, BTH, BZD, LYD, CHF, MVR, KES, CVE, LSL, KMF, SZL, KYD, BRL, AED, WST, YER, ALL, TRX, HUF, GTQ, uBTC, IDR, MWK, CUC, DKK, TWD, XCD, BBD, LRD, KZT, JOD, BYN, BIF, PLN, SDG, VUV, SEK, BDT, HNL, BWP, VND, ISK, SLL, BHD, HTG, USDt, ADA, MUR, ERN, uLTC, LKR, COP, GEL, AUD, GBP, CAD, PHP, PAB, DJF, GMD, PKR, NIO, AMD, RWF, RON, NGN, TOP, UYU, AZN, SRD, KWD, PGK, CDF, SAR, IQD, XRP, SCR, mETH, MAD, GYD, INR, LBP, ARS, MXN, CLP, BNB, CNY, KHR, LAK, HRK, BZD, SSP, XOF, XAF, MRU, NPR, mBTC

Responses
[
  {
    "user": "foo",
    "transaction_uuid": "8441e007-cd9b-4b2f-b6d6-9aefc756ea15",
    "status": "TS_SUCCESS",
    "round": "b5875ff2-92a0-456f-b232-c14e4f9f5682",
    "round_closed": false,
    "kind": "TK_BET",
    "inserted_at": "2018-05-23T10:11:59.058598",
    "id": 3541,
    "game_code": "clt_softwareid",
    "currency": "USD",
    "amount": 100500
  }
]