Perfect Money®

www.perfectmoney.is

A Programmers Guide to
API

13 March, 2007

Copyright 2007-2103 by SR & I.

website: http://perfectmoney.is
1. Introduction...................................................... 2
1.1 Overview of Perfect Money® Automation Tasks and Implementation ..............2
1.1.1 Amounts format ...............................................................................................2
1.1.2 The Perfect Money® spend. ............................................................................2
1.1.3 The Perfect Money® account name fetching. .................................................2
1.1.4 The Perfect Money® protection code confirmation. .......................................2
1.1.5 Perfect Money® account history. ....................................................................3
1.1.6 Perfect Money® account balance. ...................................................................3
1.1.7 Perfect Money® exchange rates. .....................................................................3
1.1.8 Perfect Money® e-Voucher listing. .................................................................3
1.1.9 Implementation ................................................................................................3
2. Automation Details................................................ 4

2.1 Perfect Money® spend ........................................................................................5

2.2 Perfect Money® spend preview/verification .......................................................7
2.3 Perfect Money® protection code confirmation ...................................................9
2.4 Perfect Money® account name fetching ............................................................11
2.5 Perfect Money® history .....................................................................................13
2.6 Perfect Money® balance ....................................................................................15
2.7 Exchange rates ...................................................................................................17
2.8 Perfect Money® e-Voucher listing ....................................................................18
2.9 Perfect Money® e-Voucher creation .................................................................20
2.10 Perfect Money® e-Voucher return ....................................................................22
2.11 Perfect Money® e-Voucher activation ..............................................................24
2 Example Scripts.................................................. 26
3.1 Security notes .....................................................................................................26
3.2 Disclaimer ..........................................................................................................27
3.3 PHP script to retrieve Perfect Money®account history ....................................27
3.4 PHP script to preview Perfect Money®spend ...................................................29
3.5 PHP script to fetch Perfect Money® account name ..........................................30
3.6 PHP script to display Perfect Money® balance ................................................31
3.7 PHP script to retrieve Perfect Money® e-Voucher listing ...............................32
3.8 PHP script to create Perfect Money® e-Voucher ..............................................33
1. Introduction
This document describes how to programmatically interact with the Perfect Money® web site
(located at http://perfectmoney.is). Interaction of this sort might be useful to those desiring to
automate PerfectMoney payments, verify a particular transaction has occurred, or pull account
history into a third party program.

This document describes the fields and parameters required for interfacing to the PerfectMoney
system to perform these actions.

This document is intended to be utilized by technical personnel with programming knowledge;

specifically with a working knowledge of HTML forms.

1.1 Overview of Perfect Money® Automation Tasks and Implementation

1.1.1 Amounts format

Perfect Money® system uses the following format for supported wallet currencies:
USD: min amount of transfer is 0.01
EUR: min amount of transfer is 0.01
GOLD: min amount of transfer is equivalent to 10 USD, up to 5 digits after point
BTC: min amount of transfer is 0.001, up to 6 digits after point

1.1.2 The Perfect Money® spend.

The Perfect Money® spend is a transaction initiated by the owner of an Perfect Money® account
to transfer money to another Perfect Money® account. (An Perfect Money® account holder can
never “pull” money from another account; only the owner may initiate value transfer).
Normally, an Perfect Money® spend is performed interactively by the account holder using a
web (or PCS/WAP phone) browser to submit payment information via HTML (HDML/WML)
form input.
The user interested in automation of this task may require unattended spending, or repetitive
spending without the manual data re-entry this would require using the browser method.

1.1.3 The Perfect Money® account name fetching.

The Perfect Money® account name fetching is a transaction initiated by the owner of an Perfect
Money® account to fetch the name of another Perfect Money® account. (Name of account is
actually the text entered by account owner in his/her “Account name” profile field).
Normally, you can see Account name of payee when initiating spend operation in both ordinal
WEB-interface and API spend request.
The user interested in automation of this task may want implementation of additional
confirmation of payee account.

1.1.4 The Perfect Money® protection code confirmation.

The Perfect Money® protection code confirmation is a transaction initiated by the owner of an
Perfect Money® account to complete money enrollment from another Perfect Money® account
to his/her own account. (An Perfect Money® account holder can never enter protection codes for
another accounts; only the owner may initiate protection code confirmation).
Normally, an Perfect Money® protection code confirmation is performed interactively by the
account holder using a web (or PCS/WAP phone) browser to submit payment information
(protection code) via HTML (HDML/WML) form input.
The user interested in automation of this task may require unattended confirmations, or
confirmations without the manual data re-entry this would require using the browser method.

1.1.5 Perfect Money® account history.

The Perfect Money® account history for a particular account contains all the money transactions
for the account.
Again, this act of viewing this history is normally performed interactively via a web browser.
The user interested in automation of this task may require verification of a particular transaction.

1.1.6 Perfect Money® account balance.

The Perfect Money® account balance for a particular account is the current balance of each
particular Perfect Money® currency account (USD, EUR, Gold or Bitcoin).
The balance is normally viewed using a browser.
The user interested in automation of balance may wish to display their balance or derived
information on their web site.

1.1.7 Perfect Money® exchange rates.

Users normally view the exchange rates page with a web browser, or enter currency equivalents
when performing Perfect Money® spend.
The user interested in automation of this task may wish to perform calculations based on the
current exchange rates used on the Perfect Money® system.

1.1.8 Perfect Money® e-Voucher listing.

The Perfect Money® e-Voucher listing for a particular user account contains all e-vouchers
created by the user, both activated and non-activated.

1.1.9 Implementation
The user wishing to implement Perfect Money® automation functionality has several options for
implementing the task at hand. The language and platform chosen for the task must provide the
following functionality:
1. Support for HTTPS form submission to a remote host.
2. Support for examining returned data for results.
Security Notes:
1. Do not embed your PerfectMoney account passphrase in your automation
program. Rather, prompt the user for the passphrase when the program runs.
2. Examine your automation program closely for problems. You are just as
responsible for Perfect Money® transactions initiated by an automation program
as if you had entered the transaction by hand. (i.e. Perfect Money® spends are not
reversible regardless of the initiation method).
2. Automation Details
This section provides detailed information to allow a programmer to interface his automation
program to the Perfect Money® payment system.

In general, input fields are provided to the given URL via either an HTML form of the POST or
GET variety. For instance a GET style request to retrieve the balance PerfectMoney account
101574 might look like:
https://perfectmoney.is/acct/balance.asp?AccountID=101574&PassPhrase=This1isnotReal

The history and exchange rate data is returned in comma delimited format to the requestor. The
balance, spend, and preview URLs return result data in hidden fields embedded in normal
HTML. For example, the above balance request might return:
<html>

<head>
<title>Balance</title>
</head>

<body>

<h1>Balance</h1>

<table border=1>
<tr><td><b>Account
No.</b></td><td><b>Balance</b></td></tr><tr><td>U1234567</td><td>1152.31</td></tr>
<tr><td>E1234568</td><td>276.50</td></tr>
<tr><td>G1234569</td><td>0.00</td></tr>
</table>
<input name='U1234567' type='hidden' value='1152.31'>
<input name='E1234568' type='hidden' value='276.50'>
<input name='G1234569' type='hidden' value='0.00'>
</body>

</html>
The caller can ignore all the HTML fields and pull out the return values from the hidden fields.
(See the example scripts).

In order to make API output XML valid you can add this optional parameter to any of API
request described below: api_version=1
 2.1 Perfect Money® spend
A spend may be performed by doing an HTML form post of GET or POST variety to the URL:
https://perfectmoney.is/acct/confirm.asp
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/confirm.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login (payer) 10000
PassPhrase Perfect Money® account password This1isnotReal
Payer_Account Your Perfect Money® account to spend from U1234567
Payee_Account Perfect Money® account to spend to U7654321
Amount Amount to be spent. Must be positive numerical amount. 19.95
Memo Up to 100 characters to be placed in memo section of transaction. Thanks for
The memo is visible to both payer and payee. dinner.
PAYMENT_ID Optional merchant reference number. If present, this string of up ID-322223
to 50 characters is placed in the transaction. Payer and/or payee
may search/query account history for this value.
code (Optional) Pass this value if only you want to use transfer mycode123
protection code. If protection code is present, payee must enter
this code to get money to his/her account.
Must be alpha-numerical string of length from 1 to 20 chars.
Period (Optional) You need to pass this value if only you want to use 3
transfer protection code.
Number of days you want your transfer with protection code to be
valid. If payee does not enter protection code during this period,
money will be transferred back to your account.
Must be integer value from 1 to 365 days.
 Output from the confirm.asp page will include HTML with embedded hidden form fields for
retrieving results of the spend. These are:
Output Fields from submit to
https://perfectmoney.is/acct/confirm.asp
Output Field Name Description Example Value
ERROR Spend did not occur if this field present. Text description Invalid
of error. PassPhrase.
Payee_Account_Name Name of account of payee. Actually the text payee entered John’s shop
in his/her “Account name” profile field.
Payer_Account Perfect Money® account of sender. U1234567
Payee_Account Perfect Money® account of recipient of spend. U7654321
PAYMENT_AMOUNT Numerical amount of spend as entered. This is the same 5.15
value as the Amount input field.
PAYMENT_BATCH_NUM PerfectMoney batch number generated for this transaction. 758094
Payer and/or payee may query/search account history by
this number.
PAYMENT_ID Optional merchant reference number. If present on input, ID-322223
this string of up to 50 characters is returned on output.
Payer and/or payee may search/query account history for
this value.
code (Optional) This value is present only for transfers with mycode123
protection code. If protection code is present, payee must
enter this code to get money to his/her account.
Can be alpha-numerical string of length from 1 to 20
chars.
Period (Optional) This value is present only for transfers with 3
protection code. Number of days you want your transfer
with protection code to be valid. If payee does not enter
protection code during this period, money will be
transferred back to your account.
Must be integer value from 1 to 365 days.
 2.2 Perfect Money® spend preview/verification
An Perfect Money® spend preview may be performed by doing an HTML form post of GET or
POST variety to the URL: https://perfectmoney.is/acct/verify.asp
This preview / verification function might be used to check the validity of a potential spend prior
to executing it. Note that posting to this location does not actually perform any transfer of
Perfect Money®.
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/verify.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login (payer) 10000
PassPhrase Perfect Money® account password This1isnotReal
Payer_Account Perfect Money® account of sender. U1234567
Payee_Account Perfect Money® account to spend to U7654321
Amount Amount to be spent. Must be positive numerical amount.. 19.95
Memo Up to 100 characters to be placed in memo section of payment. Thanks for
The memo is visible to both payer and payee. dinner.
PAYMENT_ID Optional merchant reference number. If present on input, this ID-322223
string of up to 50 characters is returned on output. Payer and/or
payee may search/query account history for this value.
code (Optional) Pass this value if only you want to use transfer mycode123
protection code. If protection code is present, payee must enter
this code to get money to his/her account.
Must be alpha-numerical string of length from 1 to 20 chars.
period (Optional) You need to pass this value if only you want to use 3
transfer protection code.
Number of days you want your transfer with protection code to be
valid. If payee does not enter protection code during this period,
money will be transferred back to your account.
Must be integer value from 1 to 365 days.
Output from the verify.asp page will include HTML with embedded hidden form fields for
retrieving results of the spend. These are:
Output Fields from submit to
https://perfectmoney.is/acct/verify.asp
Output Field Name Description Example Value
ERROR Verification is unsuccessful and did not occur if Invalid
this field present. Text description of error. PassPhrase.
Payee_Account_Name Name of account of payee. Actually the text John’s shop
payee entered in his/her “Account name” profile
field.
Payer_Account Perfect Money® account of sender. U1234567
Payee_Account Perfect Money® account of recipient of spend. U7654321
PAYMENT_AMOUNT Numerical amount of spend as entered. This is 5.15
the same value as the Amount input field.
PAYMENT_ID Optional merchant reference number. If present ID-322223
on input, this string of up to 50 characters is
returned on output. Payer and/or payee may
search/query account history for this value.
code (Optional) This value is present only for transfers mycode123
with protection code. If protection code is
present, payee must enter this code to get money
to his/her account.
Can be alpha-numerical string of length from 1
to 20 chars.
period (Optional) This value is present only for transfers 3
with protection code. Number of days you want
your transfer with protection code to be valid. If
payee does not enter protection code during this
period, money will be transferred back to your
account.
Must be integer value from 1 to 365 days.
 2.3 Perfect Money® protection code confirmation
An Perfect Money® protection code confirmation may be performed by doing an HTML form
post of GET or POST variety to the URL: https://perfectmoney.is/acct/protection.asp
This protection code confirmation function is used to enroll payments previously sent to your
account with protection code.
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/protection.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login (payer) 10000
PassPhrase Perfect Money® account password This1isnotReal
batch Perfect Money® batch number of transaction you want to confirm 758094
with protection code.
Must be numerical value.
code Perfect Money® protection code entered by payer of this somecode321
transaction.
Can be alpha-numerical string of length from 1 to 20 chars.
Output from the protection.asp page will include HTML with embedded hidden form fields for
retrieving results of the spend. These are:
Output Fields from submit to
https://perfectmoney.is/acct/protection.asp
Output Field Name Description Example Value
ERROR Confirmation is unsuccessful and did not occur Invalid
if this field present. Text description of error. PassPhrase.
PAYMENT_BATCH_NUM Perfect Money® batch number of transaction you 758094
just confirmed (enrolled) with protection code.
Numerical value.
code Perfect Money® protection code entered by somecode321
payer of this transaction.
Can be alpha-numerical string of length from 1
to 20 chars.
 2.4 Perfect Money® account name fetching
An Perfect Money® account name fetching may be performed by doing an HTML form post of
GET or POST variety to the URL: https://perfectmoney.is/acct/acc_name.asp
This account name fetching function is used to get Account name profile field of passed account
ID.
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/acc_name.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login 10000
PassPhrase Perfect Money® account password This1isnotReal
Account Perfect Money® account ID U1234567
Output from the acc_name.asp page will be Account name or error message if operation cannot
be completed:
Description Example
Account name fetching cannot be completed if ERROR prefix present followed by ERROR: Invalid
text description of error. PassPhrase.
Account name field of Account owner. John’s shop
 2.5 Perfect Money® history
The transaction history for an Perfect Money® account can be retrieved in CSV (Comma
Separated Value) format using the URL: https://perfectmoney.is/acct/historycsv.asp
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/historycsv.asp
Input Field Name(s) Description Example Value(s)
AccountID Perfect Money® account login (payer) 10000
PassPhrase Perfect Money® account password This1isnotReal
startmonth, These three fields define the starting day to gather account history from. 12
startday, Month should be a number from 1 to 12, day should be a number from 1 1
startyear to 31 and year should be a 4 digit number from 2007 onward. 2007
endmonth, These three fields define the ending day to gather account history from. 12
endday, Month should be a number from 1 to 12, day should be a number from 1 31
endyear to 31 and year should be a 4 digit number from 2007 onward. 2007
History will be provided for records from the beginning of the start date
fields to the end of the end date fields. For instance, the example values
would retrieve one complete month of data for the month of December
2007.
paymentsmade If present on input, Perfect Money® payments made are included in the 1
history display. To not include Perfect Money® payments made, do not
include this as an input field.
paymentsreceived If present on input, Perfect Money® payments received are included in 1
the history display. To not include Perfect Money® payments received,
do not include this as an input field.
batchfilter If present on input, only transactions that have this value as a batch 1289
number are displayed.
counterfilter If present on input, only transactions that have this PerfectMoney U1234567
account number as a counter part (payments to/from this account
number) are displayed.
metalfilter If present on input, only transactions that use the given currency units are 1
displayed. Legal values are 1, 2 and 3 corresponding to US Dollars,
Euro, and Gold troy oz.
desc If present, sort records in descending order instead of the default 1
ascending order.
oldsort If present, defines the column to sort the history transactions on. (Default Amount
is timestamp). Choices are tstamp, batch_num, metal_name,
counteraccount_id and amount corresponding to the available
columns returned.
payment_id If present on input, only transactions that have this value as a payment_id ID-123
are displayed.
 Upon submission to historycsv.asp, a set of data matching the requested input information is
returned. The report returned is of ContentType application/csv. If no records are found based on
the input parameters, a single line containing:
No Records Found.

Is returned. Otherwise, the first line returned contains 9 column names:

Time,Type,Batch,Currency,Amount,Fee,Payer Account,Payee Account,Memo

A further description of each of these items follows:

Columns returned from https://perfectmoney.is/acct/historycsv.asp
ColumnName Description Example
Batch The batch number of the transaction 1289
Time Time of transaction in GMT. 09/08/2000 00:03
Type Transaction Type. Possible values are: Income
Charge
Income
Currency Name of Perfect Money® currency transaction USD
occurred in. Possible values are:
USD
EUR
Troy oz. (GOLD)
BTC (Bitcoin)
Amount The actual numerical value of transaction. 19.95
Fee The amount of fee of the given transaction. 0.12
Payer Account PerfectMoney payer account ID. U1234567
Payee Account PerfectMoney payee account ID. U7654321
Payment ID The value optionally provided by merchant through ID-123
PerfectMoney SCI or API interface.
Memo Memo corresponding to this transaction. Income 19.95 USD from
account U1234567.
 2.6 Perfect Money® balance
The Perfect Money® for a given account may be retrieved doing an HTML form post of GET or
POST variety to the URL: https://perfectmoney.is/acct/balance.asp
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/balance.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login (payer) 100079
PassPhrase Perfect Money® account password This1isnotReal
Output from the balance.asp page will include HTML with embedded hidden form fields for
retrieving balance information. These are:
Output Fields from submit to
https://perfectmoney.is/acct/balance.asp
Output Field Name Description Example Value
U1234567 Current available balance of the account U1234567 (where 1155.29
U1234567 - can be any ID of accounts you own).
<...>
ERROR Access is unsuccessful and did not occur if this field Can't login
present. Text description of error. with passed
AccountID
and
PassPhrase
 2.7 Exchange rates
The current exchange rates for the various currencies may be retrieved doing an HTML form
post of GET or POST variety to the URL: http://perfectmoney.is/acct/rates.asp
The following input fields should be used:
Input Fields for submit to
http://perfectmoney.is/acct/rates.asp
Input Field Name Description Example Value
CUR Optional input field indicating display of exchange rates in this EUR
currency. Default is US Dollars. Choices are:
USD = US Dollars
EUR = Euro
GOLD = Gold ounces (toy)
BTC = Bitcoin

Output from the rates.asp page will be a set of comma delimited ASCII data. This date/time will
be in GMT and will be formatted like “Month/Day/Year Hour:Minutes/Seconds AM/PM”
example: “6/2/00 9:36:45 PM“ corresponding to June 2nd 2000 21:36:45 GMT. The date/time
will be followed two values (depending on USD, EUR, GOLD inputs) giving the exchange rate
per unit for the selected currency (US Dollars default).
Example of input and output:
Example 1 “Current exchange rates for EUR & GOLD to USD”
http://perfectmoney.is/acct/rates.asp

gives:
3/13/08 6:25:05 PM, 0.65 , 0.001
Which provides the US Dollars exchange rates to Euro and Gold.
 2.8 Perfect Money® e-Voucher listing
The e-Voucher listing for an Perfect Money® account can be retrieved in CSV (Comma
Separated Value) format using the URL: https://perfectmoney.is/acct/evcsv.asp
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/evcsv.asp
Input Field Name(s) Description Example Value(s)
AccountID * Perfect Money® account login (payer) 10000
PassPhrase * Perfect Money® account password This1isnotReal
startmonth, These three fields define the starting day to gather e-voucher listing 12
startday, from. Month should be a number from 1 to 12, day should be a number 1
startyear from 1 to 31 and year should be a 4 digit number from 2007 onward. 2007
Please note this date means the date when e-voucher was created.
endmonth, These three fields define the ending day to gather e-voucher listing from. 12
endday, Month should be a number from 1 to 12, day should be a number from 1 31
endyear to 31 and year should be a 4 digit number from 2007 onward. 2007
Listing will be provided for e-vouchers from the beginning of the start
date fields to the end of the end date fields. For instance, the example
values would retrieve one complete month of data for the month of
December 2007.
ev_number If present on input, only Perfect Money® e-Voucher with that number is 0123456789
included in the listing display.
batchfilter If present on input, only e-Voucher that have this value as a batch 1289
number is displayed.
counterfilter If present on input, only e-Vouchers that have this PerfectMoney account U1234567
as a counter part (payments to/from this account number) are displayed.
currency If present on input, only e-Vouchers that use the given currency units are 1
displayed. Legal values are 1, 2 and 3 corresponding to US Dollars,
Euro, and Gold troy oz.
desc If present, sort records in descending order instead of the default 1
ascending order.
oldsort If present, defines the column to sort the e-Vouvher listing on. (Default amount
is created). Choices are created, amount, currency and
batch corresponding to the available columns returned.

* Fields marked by the red star are mandatory. Other fields are optional.
 Upon submission to evcsv.asp, a set of data matching the requested input information is returned.
The report returned is of ContentType application/csv. If no records are found based on the input
parameters, a single line containing:
No Records Found.

Is returned. Otherwise, the first line returned contains 9 column names:

Created,e-Voucher number,Activation code,Currency,Batch,Payer Account,Payee
Account,Activated,Amount

A further description of each of these items follows:

Columns returned from https://perfectmoney.is/acct/evcsv.asp
ColumnName Description Example
Created Time of e-Voucher creation in GMT. 09/08/2000 00:03
e-Voucher number The number of the e-Voucher (contains 10 digits) 0123456789
Activation code The activation code of the e-Voucher (contains 16 0123456789012345
digits)
Currency Name of Perfect Money® e-Voucher c occurred in. USD
Possible values are:
USD
EUR
Troy oz. (GOLD)
BTC (Bitcoin)
Batch The batch number of the e-Voucher creation 1289
transaction
Payer Account PerfectMoney payer account ID (e-Voucher U1234567
creator).
Payee Account PerfectMoney payee account ID (e-Voucher U7654321
activator). If e-Voucher is not activated – empty
value.
Activated Time of e-Voucher activation in GMT. If e- 09/08/2000 00:03
Voucher is not activated – empty value.
Amount The actual nominal value of e-Voucher. 19.95
 2.9 Perfect Money® e-Voucher creation
Perfect Money® e-Voucher creation may be performed by doing an HTML form post of GET or
POST variety to the URL: https://perfectmoney.is/acct/ev_create.asp
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/ev_create.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login (payer) 10000
PassPhrase Perfect Money® account password This1isnotReal
Payer_Account Your Perfect Money® account to spend from U1234567
Amount Amount to be spent. Must be positive numerical amount. 19.95
As a result e-Voucher of this nominal will be created.
 Output from the ev_create.asp page will include HTML with embedded hidden form fields for
retrieving results of the spend. These are:
Output Fields from submit to
https://perfectmoney.is/acct/ev_create.asp
Output Field Name Description Example Value
ERROR e-Voucher was not created if this field present. Text Invalid
description of error. PassPhrase.
Payer_Account Perfect Money® account of e-Voucher buyer. U1234567
PAYMENT_AMOUNT Numerical amount of spend as entered. This is the total 20.05
amount you payed icluding fee.
PAYMENT_BATCH_NUM PerfectMoney batch number generated for this transaction. 758094
You may query/search account history by this number.
VOUCHER_NUM Unique number of purchased e-Voucher contaning 10 01234567891
digits.
VOUCHER_CODE Activation code of purchased e-Voucher contaning 16 0123456789123456
digits.
VOUCHER_AMOUNT Nominal amount of e-Voucher. This is the same value as 19.95
the Amount input field.
 2.10 Perfect Money® e-Voucher return
Perfect Money® e-Voucher return may be performed by doing an HTML form post of GET or
POST variety to the URL: https://perfectmoney.is/acct/ev_remove.asp
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/ev_remove.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login (buyer) 10000
PassPhrase Perfect Money® account password This1isnotReal
ev_number Your Perfect Money® e-Voucher unique number you want to 01234567891
return.
In case of success you will get e-Voucher nominal amount back
to account you used to create this e-Voucher.
 Output from the ev_remove.asp page will include HTML with embedded hidden form fields for
retrieving results of the spend. These are:
Output Fields from submit to
https://perfectmoney.is/acct/ev_remove.asp
Output Field Name Description Example Value
ERROR e-Voucher was not returned if this field present. Text Invalid
description of error. PassPhrase.
VOUCHER_NUM Unique number of returned e-Voucher contaning 10 digits. 01234567891
VOUCHER_AMOUNT Nominal amount of e-Voucher. 19.95
Also amount that was credited back to your account.
Payer_Account Perfect Money® account of e-Voucher buyer. U1234567
PAYMENT_BATCH_NUM PerfectMoney batch number generated for this transaction. 758094
You may query/search account history by this number.
 2.11 Perfect Money® e-Voucher activation
Perfect Money® e-Voucher activation may be performed by doing an HTML form post of GET
or POST variety to the URL: https://perfectmoney.is/acct/ev_activate.asp
The following input fields should be used:
Input Fields for submit to
https://perfectmoney.is/acct/ev_activate.asp
Input Field Name Description Example Value
AccountID Perfect Money® account login (payer) 10000
PassPhrase Perfect Money® account password This1isnotReal
Payee_Account Perfect Money® account to activate e-Voucher to. U1234567
e-Voucher nominal amount was credited to this account.
ev_number Your Perfect Money® e-Voucher unique number you want to 01234567891
activate.
ev_code Activation code of e-Voucher. 0123456789123456
 Output from the ev_activate.asp page will include HTML with embedded hidden form fields for
retrieving results of the spend. These are:
Output Fields from submit to
https://perfectmoney.is/acct/ev_activate.asp
Output Field Name Description Example Value
ERROR e-Voucher was not activated if this field present. Text Invalid
description of error. PassPhrase.
VOUCHER_NUM Unique number of activated e-Voucher contaning 10 01234567891
digits.
VOUCHER_AMOUNT Nominal amount of e-Voucher. 19.95
This amount was credited to Payee_Account.
VOUCHER_AMOUNT_CURRENCY Currency of amount. Possible values are: 19.95
1 - USD
2 - EUR
3 - GOLD
7 - BTC
Payee_Account Perfect Money® account of e-Voucher payee. U1234567
PAYMENT_BATCH_NUM PerfectMoney batch number generated for this 758094
transaction. You may query/search account history by
this number.
 2 Example Scripts
The following scripts may be used as examples to guide you in your own use of the Perfect
Money® system. Please note, that since we use fopen() function for opening https:// URLs, you
will need PHP 4.3.0 or newer installed to run them.

3.1 Security notes

If you are placing an automation script in a situation where it accepts input data from untrusted
sources, you’ll want to try and protect your script from malicious attempts to make it do
something other than it should. Some hints in this regard:
1. Do not embed your PerfectMoney account passphrase in your automation program.
Rather, prompt the user for the passphrase when the program runs.
2. Examine your automation program closely for problems. You are just as
responsible for Perfect Money® transactions initiated by an automation program as
if you had entered the transaction by hand. (i.e. Perfect Money® spends are not
reversible regardless of the initiation method).
3. Escape any system arguments. If you are using PHP take a look at the
EscapeShellCmd and EscapeShellArg functions. If you are doing SQL commands,
replace all delimiters in input data.
 3.2 Disclaimer
Disclaimer
The Author [PerfectMoney Ltd.] accepts no responsibility for damages to
persons, property or data incurred through the use of these script(s). To the
maximum extent permitted by law, in no event shall the Author [PerfectMoney
Ltd.] be liable for any damages whatsoever (including, without limitation,
damages for loss of business profits, business interruption, loss of business
information, or other pecuniary loss) arising out of the use or inability to
use this software, even if the Author has been advised of the possibility of
such damages.
This product is supplied as-is, with no warranties express or implied.
Use this software at your own risk.

3.3 PHP script to retrieve Perfect Money®account history

This is a sample script, that demonstrates parsing account history to array.
<?php

/*

This script demonstrates querying account history

using PerfectMoney API interface.

*/

// trying to open URL

$f=fopen('https://perfectmoney.is/acct/historycsv.asp?startmonth=1&startday=1&startyear=2007&endm
onth=1&endday=27&endyear=2008&AccountID=10000&PassPhrase=111111', 'rb');

if($f===false){
echo 'error openning url';
}

// getting data to array (line per item)

$lines=array();
while(!feof($f)) array_push($lines, trim(fgets($f)));

fclose($f);

// try parsing data to array

if($lines[0]!='Time,Type,Batch,Currency,Amount,Fee,Payer Account,Payee Account,Payment ID,Memo'){

// print error message

echo $lines[0];

}else{

// do parsing
$ar=array();
$n=count($lines);
for($i=1; $i<$n; $i++){

$item=explode(",", $lines[$i], 10);

if(count($item)!=9) continue; // line is invalid - pass to next one
$item_named['Time']=$item[0];
$item_named['Type']=$item[1];
$item_named['Batch']=$item[2];
$item_named['Currency']=$item[3];
$item_named['Amount']=$item[4];
$item_named['Fee']=$item[5];
$item_named['Payer Account']=$item[6];
$item_named['Payee Account']=$item[7];
$item_named['Payment ID']=$item[8];
$item_named['Memo']=$item[9];
array_push($ar, $item_named);
}

echo '<pre>';
print_r($ar);
echo '</pre>';
?>
 3.4 PHP script to preview Perfect Money®spend
This is a sample script, that demonstrates sending PerfectMoney spend request and parsing
output data to array.
<?php

/*

This script demonstrates transfer proccess between two

PerfectMoney accounts using PerfectMoney API interface.

*/

// trying to open URL to process PerfectMoney Spend request

$f=fopen('https://perfectmoney.is/acct/confirm.asp?AccountID=myaccount&PassPhrase=mypassword&Paye
r_Account=U987654&Payee_Account=U1234567&Amount=1&PAY_IN=1&PAYMENT_ID=1223', 'rb');

if($f===false){
echo 'error openning url';
}

// getting data
$out=array(); $out="";
while(!feof($f)) $out.=fgets($f);

fclose($f);

// searching for hidden fields

if(!preg_match_all("/<input name='(.*)' type='hidden' value='(.*)'>/", $out, $result,
PREG_SET_ORDER)){
echo 'Ivalid output';
exit;
}

$ar="";
foreach($result as $item){
$key=$item[1];
$ar[$key]=$item[2];
}

echo '<pre>';
print_r($ar);
echo '</pre>';

?>
 3.5 PHP script to fetch Perfect Money® account name
This is a sample script, that demonstrates fetching PerfectMoney account name and by account
id.
<?php

/*

This script demonstrates fetching account name by account ID

using PerfectMoney API interface.

*/

// trying to open URL to process PerfectMoney account name fetching

$f=fopen('https://perfectmoney.is/acct/acc_name.asp?AccountID=myaccount&PassPhrase=mypassword&Acc
ount=U987654', 'rb');

if($f===false){
echo 'error openning url';
}

// getting data
$out="";
while(!feof($f)) $out.=fgets($f);

fclose($f);

echo '<pre>';
echo $out;
echo '</pre>';

?>
 3.6 PHP script to display Perfect Money® balance
This is a sample script, that demonstrates sending PerfectMoney balance request and parsing
output data to array.
<?php

/*

This script demonstrates querying account balance

using PerfectMoney API interface.

*/

// trying to open URL to process PerfectMoney Spend request

$f=fopen('https://perfectmoney.is/acct/balance.asp?AccountID=10000&PassPhrase=111111', 'rb');

if($f===false){
echo 'error openning url';
}

// getting data
$out=array(); $out="";
while(!feof($f)) $out.=fgets($f);

fclose($f);

// searching for hidden fields

if(!preg_match_all("/<input name='(.*)' type='hidden' value='(.*)'>/", $out, $result,
PREG_SET_ORDER)){
echo 'Ivalid output';
exit;
}

// putting data to array

$ar="";
foreach($result as $item){
$key=$item[1];
$ar[$key]=$item[2];
}

echo '<pre>';
print_r($ar);
echo '</pre>';

?>
 3.7 PHP script to retrieve Perfect Money® e-Voucher listing
This is a sample script, that demonstrates parsing e-Voucher listing to array.
<?php

/*

This script demonstrates getting complete listing

of all e-Vouchers created by the Perfect Money user.

*/

// trying to open URL

$f=fopen('https://perfectmoney.is/acct/evcsv.asp?AccountID=10000&PassPhrase=111111', 'rb');

if($f===false){
echo 'error openning url';
}

// getting data to array (line per item)

$lines=array();
while(!feof($f)) array_push($lines, trim(fgets($f)));

fclose($f);

// try parsing data to array

if($lines[0]!='Created,e-Voucher number,Activation code,Currency,Batch,Payer Account,Payee
Account,Activated,Amount'){

// print error message

echo $lines[0];

}else{

// do parsing
$ar=array();
$n=count($lines);
for($i=1; $i<$n; $i++){

$item=explode(",", $lines[$i], 9);

if(count($item)!=9) continue; // line is invalid - pass to next one
$item_named['Created']=$item[0];
$item_named['Number']=$item[1];
$item_named['Code']=$item[2];
$item_named['Currency']=$item[3];
$item_named['Batch']=$item[4];
$item_named['Payer Account']=$item[5];
$item_named['Payee Account']=$item[6];
$item_named['Activated']=$item[7];
$item_named['Amount']=$item[8];
array_push($ar, $item_named);
}

echo '<pre>';
print_r($ar);
echo '</pre>';

?>
 3.8 PHP script to create Perfect Money® e-Voucher
This is a sample script, that demonstrates sending PerfectMoney e-Voucher purchase request and
parsing output data to array.
<?php

/*

This is a sample script, that demonstrates sending

PerfectMoney e-Voucher purchase request and parsing
output data to array.

*/

// trying to open URL to process PerfectMoney e-Voucher creation

$f=fopen('https://perfectmoney.is/acct/ev_create.asp?AccountID=myaccount&PassPhrase=mypassword&Pa
yer_Account=U987654&Amount=0.01', 'rb');

if($f===false){
echo 'error openning url';
}

// getting data
$out=array(); $out="";
while(!feof($f)) $out.=fgets($f);

fclose($f);

// searching for hidden fields

if(!preg_match_all("/<input name='(.*)' type='hidden' value='(.*)'>/", $out, $result,
PREG_SET_ORDER)){
echo 'Ivalid output';
exit;
}

$ar="";
foreach($result as $item){
$key=$item[1];
$ar[$key]=$item[2];
}

echo '<pre>';
print_r($ar);
echo '</pre>';

?>