iGolder API: <GetSubAccountTransactionHistory>
Downloading my transaction history
With iGolder, you can download the transactions history of any of your sub-accounts.
Downloading your transaction history may be useful if you want to
perform additional processing regarding your transactions, such as reconciling your
iGolder transactions with your accounting software. Our web
service API to also enables you to search
your transaction history. For instance, you may search a transaction
by date or by amount, and iGolder will return you a list of transactions
matching your search criteria.
||Optional parameter to return transactions from a specific
date and time. For instance, if you are only interested
about last week's transactions, then you specify the date of the
previous week. By specifying a date range, you make your
automation faster and iGolder more responsive to your requests.
||Optional parameter to return transactions older than a
specific date and time.
If you know the exact date of a transaction, simply set the
DateFrom and DateUntil to the same value, and iGolder will
return all transactions on that day. The date may include
the time of the day, such as 2009-02-14 @ 14:39:18. If the
time is not specified, then iGolder will assume the full day.
|Optional parameters to return transactions within the amount range. This
parameter is very useful when searching a transaction you know
||Optional parameter to return transactions matching an email
address. You may specify a wildcard such as * or ?
||Optional parameter to return transactions matching the name
of a customer. You may specify a wildcard such as * or ?
||Optional parameters to return transactions containing a keyword in
the description note.
||Optional parameter to return the transaction matching a
Optional parameter to return transactions of a given
type, such as payments sent, payments received, payments
refunded and payments in dispute:
- PaymentsSent: Return all transaction where
you initiated the payment (you sent gold to someone).
- PaymentsReceived: Return all transactions
where you received gold from a customer. Such
transactions include payments which are
still in Safetransit™
as well as refunded payments.
- SubAccountTransfer: Return all transactions
involving a transfer with another sub-account.
- PaymentsPendingInSafetransit: Return only
transactions still in Safetransit, waiting for the gold
to clear in your account. If you made a payment to a customer and the gold is
still in Safetransit,
then the payment will be listed as PaymentsSent.
- PaymentsRefunded: Return all transactions you
provided any refund to your customer. The refund
may be a partial or a full refund.
- PaymentsInDispute: Return all transactions
currently in dispute. A transaction in dispute may
have been initiated by you or by your customer.
- PaymentCompleted: The payment
- Sent: Only payments sent
- Received: Only payments received
- Transfers: Only transfers between sub-accounts
- Safetransit: Only the payments in Safetransit
- Refunded: Only payments refunded
- Dispute: Only the payments in dispute
<DateFrom>2009-02-14</DateFrom> <!-- [Optional] Return all transactions from a specified date -->
<DateUntil>2050-12-31</DateUntil> <!-- [Optional] Return all transaction until a specified date -->
<AmountFrom>0</AmountFrom> <!-- [Optional] Return all transactions larger or equal to a quantity of gold -->
<AmountTo>999999</AmountTo> <!-- [Optional] Return all transactions smaller or equal to a quantity of gold -->
After invoking the web service https://www.iGolder.com/api.ashx,
iGolder will return you a list of transactions matching your search
criteria. For performance, iGolder will return the first 1000 transactions matching your query.
If you need to fetch more than 1000 transactions, then you must split your search request into multiple queries by specifying a date range <DateFrom>
<CurrencyId>Grams of Gold</CurrencyId>
<Memo>Consectetuer tempor placerat invidunt takimata dolor nonumy dolore tincidunt diam.</Memo>
|Unique identifier for the transaction. This value is always a
||Transaction date, formatted in your timezone. If the
time is incorrect, please configure your timezone in the account settings.
||Transaction amount, in grams of gold. The amount is
positive if you received a gold payment, and the amount is
negative when sending gold to someone else.
The transaction amount always includes the transfer fee.
||Transaction Fee, in grams of gold, when
receiving a gold payment. The transaction fee is always
zero when sending gold to someone else.
||The email of the sender, if the email is not provided this field contain the account name.
||Email or Alias of the recipient of gold.
||Your sub-account balance, in grams of gold, after executing
the transaction. This amount is the total balance in your
sub-account, including any gold in Safetransit.
||Always Grams of Gold. That value is there for compatibility only.
||Type of transfer can be one of the following value:
- Gold Payment: when you sent gold to someone else.
- Gold Received: when you received gold from someone else.
- Sub-Account Transfer: when you transfer gold to
- Refund: The payment was refunded.
||The description of the transaction. You may change the
transaction description online in the transaction details.
The maximum number of transactions that can be returned from a
GetSubAccountTransactionHistory API call is 1000.
This is a test for