|
DPSAUTHD COM Object for PowerBuilder
DPSAUTHD.DLL is a Windows DLL designed for use by PowerBuilder applications,
providing a simple, reliable interface to Payment Express®. DPSAUTHD requires
DPSAUTHS.DLL to be installed for correct operation. DPSAUTHS.DLL is a COM
object that encapsulates the XML interface to the Paymentr Express® Host via https posts.
|
Technical Specifications/Features: |
|
PowerBuilder is a 4th Generation Language (4GL), Rapid Application Development
(RAD) platform. PowerBuilder is an open platform with wide support for commonly
used and emerging technology standards, and can easily integrate with
components across the enterprise. |
Installation Instructions
Download the latest DPSAUTHS & DPSAUTHD COM Objects and run the Setup programs.
See
here for full details on DPSAUTHSSL. |
Using DPSAUTHD.DLL
Input Parameters
|
BillingId |
32 character. space padded, left justified. Contains merchant
billing reference. May not be blank. |
|
CardHolderName |
64 character. space padded, left justified. Contains cardholder
name. May be blank but must be padded to minimum length of 64 characters. |
|
CardNumber |
20 character. space padded, left justified. Numeric card number
without hypens (-) or embedded spaces. |
|
DateExpiry |
4 character numeric. Conatins expiry date of card in mmyy (month
year) format. |
|
MerchantReference |
64 character. space padded, left justified. Contains free text
mecrhant reference associated with the transaction.. May be blank but must be
padded to minimum length of 64 characters. |
|
Password |
32 character. space padded, left justified
Used in conjunction with the username to specify the account accessed. |
|
Username |
32 character. space padded, left justified
Used in conjunction with the password to specify the account accessed. |
Output Parameters
|
Result |
Single character result - 1 indicates success. 0 indicates
failure. |
|
ReCo |
2 character response code indicating failure reason if Result is
not equal to "1" |
|
ResponseText |
20 character response text indicatesing reason for failure if
Result is not equal to "1" |
|
"C" function prototype: |
long DpsAddValidBillCard(const char* username, const char*
password, const char* cardnumber, const char* dateexpiry,
const char* cardholdername, const char* merchantreference,const char*
billingid,
char* result, char* reco, char* responsetext) |
PowerBuilder Sample
SUBROUTINE DpsAddValidBillCard(ref string Username, ref string Password, ref
string CardNumber, ref string DateExpiry, ref string CardholderName, ref string
MerchantReference, ref string BillingId, ref string Result, ref string ReCo,
ref string ResponseText) LIBRARY "DPSAUTHD.DLL"
[Powerscript]
' ensure all strings are space spadded to at least the minimum length of the
parameter
string Username =
"DpsAuthD_Test_User
" ' ensure space padded to 32
string Password = "het612af3kjd7ed46241298klbf
" ' ensure space padded to 32 characters
string CardNumber = "4111111111111119 " ' 20
characters
string DateExpiry = "0109"
string CardHolderName="CARDHOULDER"+space(64)
string MerchantReference="MER REF 123"+space(64)
string BillingId="BILL123455"+string(32)
string Result=space(1)
string ReCo=space(2)
string ResponseText=space(20)
DpsAddValidBillCard(Username,Password,CardNumber,DateExpiry,CardHolderName,MerchantReference,BillingId,
Result,ReCo,ResponseText)
MessageBox("", result)
|