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.

Requirements/Downloads:



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)