| 1 |
Write a script or program, for example using PERL, PHP or Visual Basic, that will
create text consisting of a single line in the following format:
BAL<TAB><holding_number><TAB><passphrase><TAB><reference_number>
where:
- BAL = the name of the service being requested (BAL indicates a balance retrieval);
- <holding_number> = the number of your Holding in the format XX-XX-XX-X;
- <passphrase> = the current passphrase of your Holding;
- <reference_number> = an optional reference number that the GoldMoney system will include in the response;
- <TAB> = the TAB character (ASCII 0x09).
|
| 2 |
Programmatically submit the text, as an HTML form field using the HTTP POST method,
to the following URL:
https://secure.goldmoney.com/user/auto.php
Prior to submission, you must also explicitly set/override the Content-Type field
in the HTTP header to application/x-www-form-urlencoded. Various libraries exist
that enable you to programmatically send HTTP messages and override HTTP headers, for
example cURL (Linux) and MSINET (Microsoft). Depending on which library you use, you
may need to explicitly construct the entire HTTP message header in your program
(you do not need to do this when using cURL or MSINET).
Furthermore, the name of the HTML form field that contains the populated template must
be set to either GM_AUTO or to gm_auto.
|
| 3 |
Interpret the result that is returned by the GoldMoney system. Your script
or program should be written so that it can identify errors as follows:
If the response does not contain a set of <pre> </pre> tags,
then a serious error occurred such as an HTTP timeout or an authentication error.
Alternatively, if the response contains a set of <pre> </pre> tags,
then an error will be indicated by an [ERROR] tag. A description of the error will follow the [ERROR] tag.
|
|
