iGolder API Reference: <SubAccountSendPayment>

This page contains the technical documentation for sending a gold payment to another iGolder member.  If you wish to automate sending payments to your trading partners, then you will find this documentation very handy.

 

To get started, you need to enable automation to your iGolder account.  For your security, all new accounts are have automation disabled by default.  Next, you need to invoke the web service <SubAccountSendPayment>.  It is simple: you supply the email or alias of the person you wish to send gold as well as the amount of gold you wish to send... Voilà!  Optionally, you may supply other parameters such as a description of the payment or the Safetransit time.


Requested Value Description
SubAccountId Identifier of the sub-account you wish to take (withdraw) gold.
SecurityTokenId Security password of your sub-account.  For more information, visit Where can I find my Sub-Account ID and Security Token ID?
TransactionId Identifier for the transaction. This value identifier must be a unique GUID for each transaction.  You are responsible of generating the GUID yourself; use the built-in method of your programming language to generate a new GUID for the Transaction ID.
Payee Email or alias of the member you wish to send gold.  You may also specify the GUID of sub-account ID you wish to send gold.
PayeeName [Optional] The name of the member you wish to send gold.  This field is useful for making a gold payment to a new member; iGolder will create an account with the email and payee name, and invite the new member (by email) to claim his/her gold.
If you leave the payee name blank, then iGolder will only transfer gold to existing iGolder members.  If the email is not found in the database and the payee name is blank, then iGolder will not execute the transaction.
AmountGold Amount you wish to transfer to the payee, in grams of gold.
AmountFiat Payment amount in a fiat currency, such as United States Dollars (USD) or Euros (EUR).
This parameter is mutually exclusive to AmountGold.
The AmountFiat is purely for convenience; iGolder will calculate the weight of gold to transfer from the current market exchange rate.
Anonymous Send an anonymous payment by keeping your email address private.  If you set this value to True, then iGolder will simply display your account name without your email address.  If your trading partner wishes to communicate with you, he/she will have to send a private message.
Description Payment description. This memo will be visible to both parties, you and the payee.
Safetransit How long you wish the transaction to remain in Safetransit™.  The benefit of the Safetransit parameter is protecting you from non-shipment or misrepresentation of merchandise.  Until the gold clears from Safetransit, you may stop the payment if you feel necessary.  There is no limit on the amount of time a transaction may remain in Safetransit, however be nice to your trading partner by specifying a fair Safetransit time.  For instance, if a transaction is "instant" or "semi-instant", then 15 minutes should be sufficient.  Likewise, if you specify a long Safetransit time and you receive your product, then you may clear the payment so the payee may access his/her gold.

If you do not specify any Safetransit value, then iGolder will use the shortest Safetransit time, respecting the Minimum Safetransit Time

Examples of <Safetransit>:
<Safetransit>15m</Safetransit>  <!-- 15 minutes in Safetransit -->
<Safetransit>12h</Safetransit>  <!-- 12 hours in Safetransit -->
<Safetransit>30d</Safetransit>  <!-- 30 days in Safetransit -->

 

<SubAccountSendPayment> <SubAccountId>cbcc42cd9d82498285099a7c457f8c9b</SubAccountId> <SecurityTokenId>1d826ccc563b463fbcfba784dd176fcf</SecurityTokenId> <TransactionId>1e38041f7aac4ad3a2287a87df6e85b4</TransactionId> <!-- must be a valid unique GUID for each transfer --> <Payee>Bob@iGolder.com</Payee> <PayeeName>Bob</PayeeName> <AmountGold>100</AmountGold> <Anonymous>False</Anonymous> <Description>100 grams of gold for the boat (Invoice #12345)</Description> <Safetransit>14d</Safetransit> </SubAccountSendPayment>

 

After invoking the web service <SubAccountSendPayment>, iGolder will return you a confirmation message for the transaction.  The fields returned are the same as for downloading transactions.

 

Alice sending a payment of 100 grams of gold to Bob

 

<Transaction> <SubAccountId>cbcc42cd9d82498285099a7c457f8c9b</SubAccountId> <SubAccountName>Alice</SubAccountName> <TransactionId>1e38041f7aac4ad3a2287a87df6e85b4</TransactionId> <Date>2009-10-01 12:09:22</Date> <AmountGold>-100.000</AmountGold> <AmountUSD>-3221.18</AmountUSD> <AmountEUR>-2215.54</AmountEUR> <AmountGBP>-2018.03</AmountGBP> <Fee>0.000</Fee> <FromName>Alice</FromName> <FromEmail>alice@igolder.com</FromEmail> <ToName>Bob</ToName> <To>Bob@iGolder.com</To> <Description>100 grams of gold for the boat (Invoice #12345)</Description> <DateSafetransitUntil>2009-10-15 12:09:22</DateSafetransitUntil> <ClosingBalance>449.600</ClosingBalance> </Transaction>

 

The returned structure is of type <Transaction>, the same data structure is returned when you invoke the web service <SubAccountGetTransactionHistory>.

 

Returned Value Description
SubAccountId Identifier of the sub-account where the gold was taken.  This identifier is the same as the one your provided in <SubAccountSendPayment>.  This identifier is returned for orthogonality with the API <SubAccountGetTransactionHistory> which returns transactions all sub-accounts.
SubAccountName Name of the sub-account where the gold was taken.  The name is returned for convenience in case you need to troubleshoot your web application.
TransactionId Identifier of the transaction.  This identifier is the same as the one your provided in <SubAccountSendPayment>.  This identifier is returned for orthogonality with the API <SubAccountGetTransactionHistory> which returns multiple transactions.
Date Date and time of the transaction in UTC/GMT format.  If you wish to display this date in your timezone, then you have to perform some arithmetic to adjust the UTC/GMT date to the local time.
AmountGold Amount of gold (in grams) taken from your account and sent to the payee.  The payee will receive a smaller quantity of gold because a transaction fee is applied when receiving gold.  Since you are making a payment, this value is always negative.  On the other hand, when you download your transaction history <SubAccountGetTransactionHistory>, a positive value means you received gold, and a negative value means you sent gold.  Since the API <SubAccountSendPayment> always send gold, the value of AmountGold is always negative.
AmountUSD
AmountEUR
AmountGBP
...more...
Current market exchange rate of the transaction value (AmountGold) in a fiat currency, such as United States Dollars (USD) or Euros (EUR), Great Britain Pound (GBP).  You may add or remove fiat currencies by clicking on the link iGolder Settings at the top right of the page.  If you wish to know the value of your closing balance, simply do the cross-multiplication.  The value in fiat currency is purely for convenience, and because of the currency market fluctuation, this value changes constantly.
Fee Since you are sending gold, the transaction fee is always zero.  The receiver (payee) is charged the transaction fee.
FromName Name of the sub-account of the sender.  Since you are making the payment, it is your sub-account name.
FromEmail Email of the sender of the payment.  This email address is the address associated with the sub-account you sent the gold.
ToName Name of the sub-account receiving the gold.
To Email or alias associated with the sub-account receiving the gold.
Description Description of the transaction.
DateSafetransitUntil Date and time when the transaction will clear from Safetransit™.  As the sender, it means you have until that date to stop your payment.  Once the transaction clears from Safetransit, the payment becomes non-repudiable.  This date and time value is expressed in the UTC/GMT format.
ClosingBalance Amount of gold (in grams) remaining your sub-account after sending the payment.  You may use this value to send yourself an email if the quantity of gold is below a threshold so you may take action, such as purchasing more gold, or transfer gold from another sub-account.

 

 

 

 

Since August 1st, 2013 iGolder is no longer accepting new accounts and balances can only be redeemed. During the past years, we have been recommending Bitcoin more than our own payment system. We believe in physical gold ownership, and developed iGolder as a mechanism for people to acquire physical gold by trading with one another.

Since iGolder has a central point of failure (our server may be raided by thugs wearing some kind of uniform), we feet it is safer for us to cease operations. The iGolder experiment has been personally rewarding as we met many gold enthusiasts and also learned about Bitcoin in the process. For those who have no idea what Bitcoin is, we recommend doing your own research. Bitcoin is far superior to iGolder in every way, both in privacy and security as our server is always vulnerable to confiscation. Bitcoin is a communication protocol with a built-in "escrow service" capable of protecting both the buyer and the seller, rendering our Safetransit completely redundant. To learn more about the Bitcoin protocol and its feature, please watch "http://www.youtube.com/watch?v=mD4L7xDNCmA (Bitcoin 2012 London: Mike Hearn).

For those having gold in their iGolder account, we will ship the physical metal to anyone having more than 1 ounce of gold, assuming the owner is willing to assume the shipping costs. For smaller quantities, we offer to settle in Bitcoin, however we will also settle with any other reasonable payment system. We will give everyone at least two full years (until 2016) to contact us to claim their gold. After that period, any unclaimed gold will go to fund an economic development project in Honduras helping local people to become entrepreneurs.

We sincerely wish you the best in life and hope to keep in contact with you.

Yours in liberty,
The iGolder Team.


Update 2014: Since we announced we no longer accept gold transfers, we have received countless emails asking to keep the free gold charts and the PGP encryption tools. We plan to keep running the domain iGolder.com for both the gold charts and the encryption tools. Better, we are developing state of the art open-source software for a secure decentralized social network with a built-in wallet. We will announce when we have a product ready for use. Stay tuned!