als_process_credit_card.cgi

Top  Previous  Next

The AL-Pro Web Portal provides support for secure on line credit card processing allowing Credit card transactions to be fully integrated with AL-Pro Reporting and batch functions. An AL-Pro Credit card Server is required to support this API call. The als_credit_card_server_available.cgi can be used to check the availability of a Credit Card server.

 

This method is only supported via SSL so that user credit card information is never sent via an un-encrypted channel.

 

When a credit card is process a call is automatically made to als_insert_payment.cgi and the results of the Credit Card approval as well as the payment entry is returned as XML.

 

Note:Testing can be done by setting the default settings to allow for Credit cards to be "authorized only".

 

https://localhost/als_process_credit_card.cgi?reservation=38311&ccexp=0209&ccnumber=XXXXXXXXXXXX&cccid=0056&amount=145.32

 

Name and address information is obtained from the reservation directly. If the credit card name is different than the reservation name then the CCName param can be used to over-ride the reservation data default. Address information is obtained from the reservation itself so the reservation must have address information if AVS is set on.

 

Testing Credit Cards

 

Inputs

Parameter

Description

Required

Example

Data Type

reservation

reservation used for this credit card

 

Required

reservation=432121

Integer

amount

amount of the payment

 

Required

amount=100.47

Currency

ccexp

Credit Card Expiration Date in the format of MM/YY

Required

ccexp=0907

String

ccnumber

Credit Card Number

Required

ccnumber=12234566783

String

cccid

Information from the back of the card as Card Verification Value

 

Required

cid=222

String

ccname

Name on the Credit Card if different than the name used in the reservation.

 

must be formatted in the format of

lastname,firstname

 

Optional

ccname=smith, john

String

AuthorizeOnly

 

Can be used in Testing

 

Optional

 

authorizeonly=true

 

Boolean

 

ControlNO

 

 

 

 

 

 

whenever a payment is posted to AL-Pro a Control Number is created. To process a credit card a control number is required. When used with als_insert_voucher_payment.cgi the control number is created internally and used for the credit card authorization.

 

Optional

 

 

 

 

 

 



guarantee

 

The guarantee param will authenticate a credit card without actually charging it. This does a check to see if the card has been reported stolen. Note: when using the gurantee params and checking for success you need to check both '00' (double zero) or '85' for success

 

Optional

 

guarantee=true

 

Boolean


























 

 

Outputs

Parameter

Description

Example

Data Type

ResponseCode

Success will return an approval of '00' (double zero)

If you are using the guarantee param success will also include '85' so you need to check '00' or '85' for guarantees

 

responsecode="00"

String

Responsetext



String

ApprovalCode



String

PostedReference



String

 

<root>

<creditcardauthorization>

<row user="2" desk="1" merchantcode="2" reservation="38311" amount="0.01" credit="False" ccno="XXXXXXXXXXXX0021" ccexp="0209" nameoncard="Smith,John" cardpresent="False" verifycardonly="False" controlno="0" responsecode="00" responsetext="NO  MATCH,CID:N,AVS:N" approvalcode="024321" postedreference="663" manualauthorization="False" manualapprovalcode="" cardswiped="False" trackno="0" trackstring="" authorizeonly="True" verifycredittrans="False" origtrackread="" usecid="True" cid="0056" needavs="True" streetaddress="" zipcode="83712"/>

</creditcardauthorization>

<payments>

<row paycode="32025" reservation="38311" base="1" amount="0.01" paytype="5" referencevalue="" datevalue="9/24/2007" timevalue="13:04" voucheramount="" username="Murphy, Sheila" basename="Maui" paytypename="Internet Prepaid"/>

</payments>

</root>