Payments

Get Payments

Changed on

Returns a list of payments.

get/v1/payments

Request

  • Base URL
    https://api.aghanim.com/s2s
  • URL
    https://api.aghanim.com/s2s/v1/payments
  • Auth
    HTTP bearer

Query parameters

limitinteger

A limit on the number of objects to be returned

offsetinteger

The number of objects to skip

start_atinteger

Optional start of the time range to filter, in Unix timestamp format (seconds)

end_atinteger

Optional end of the time range to filter. Mandatory if start_at is specified.

order_by'created_at' | 'modified_at' | 'status_updated_at'

Field by which the start_at/end_at range is filtered and the records are sorted

search_stringstring

Search across order_id, email, receipt_number, payment_id, status, country, user_id.

user_idstring
order_idstring
statusstring

Optional comma separated list of status

countriesstring

Optional comma separated list of ISO 3166-1 alpha-2 country codes (e.g. US,DE).

Response

Successful Response

user_idstring required

The user ID of the payment

player_idstring

The player ID of the payment

modified_atinteger

The time of the last modification

player_namestring

The name of the player

item_idstring

The ID of the purchased item. Deprecated: use items instead.

item_namestring

The name of the purchased item. Deprecated: use items instead.

payment_method_namestring required

The name of the payment method

sales_channel'game_hub' | 'checkout' | 'android_sdk' | 'checkout_link'
currencystring required

The currency of the payment

countrystring

The ISO code country of the payment

payment_idstring

The ID of the payment

payment_numberstring required

The number of the payment in receipt

receipt_numberstring required

The number of the payment in receipt

checkout_profile_idstring

The ID of the user checkout profile

order_idstring

The ID of the order

card_last_4_digitsstring

The last 4 digits of the card

card_schemestring

The scheme of the card

card_issuer_bankstring

The name of the bank that issued the card, resolved from the card BIN. Best-effort: empty when the issuer is unknown, the BIN is not in the dictionary, or the payment was not made with a card. Legal names are returned as recorded by the BIN dictionary and are not canonicalized, so they are not a reliable grouping key.

card_issuing_countrystring

The ISO 3166-1 alpha-2 country code of the card issuer, resolved from the card BIN. Best-effort: empty when the BIN is not in the dictionary or the payment was not made with a card. This is the country of the card, not the country of the payment (see country) or of the billing address.

totalinteger required

The total amount of the payment

total_usdnumber

The payment amount converted at the exchange rate into dollars (Sales or GMV)

total_usd_revenuenumber

The profit in dollars, that is total_usd excluding all fees and taxes

user_local_priceinteger

The total amount in local currency of the payment before all discounts

currency_minor_unitinteger required

The minor unit of the currency

feesobject[]

This includes all charges related to a payment, including the payment system fee, Aghanim fee, conversion, etc

taxesobject[]

These are the taxes that arise from sales (the Withholding Tax is not included)

refund_customer_idstring

The ID of the refunded customer

refund_reasonstring

The reason for the refund or chargeback. For a chargeback, this is the chargeback reason category. The reason for each refund is in refunds[].reason

ipunknown
created_atinteger required

The time of the payment creation

fail_reasonstring

The reason of the payment failure

fail_reason_codestring

The code of the payment failure reason

status_updated_atinteger

The timestamp of the status update

order_fieldinteger

The transaction's serial number in the status list. Can be used to sort the transaction by the status list

metadataobject

The metadata object of the order

platform'any' | 'ios' | 'android' | 'other'
three_d_secure_flow'none' | 'challenge' | 'frictionless'
three_d_secure_result'not_attempted' | 'authenticated' | 'failed'
applied_reward_pointsinteger

The applied reward points for the order that allowed you to receive a discount.

Changes

  • e9e2fbe16b24Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the required property /// to the response with the status

  • 0ef278347679Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status