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.

 

 

 

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

CardPresent

 

 

 

If the credit card is present. Default is false. only provided for use if needed in in non-internet transactions

 

Optional

default is false

 

 

cardpresent=false

 

 

 

Boolean

 

 

 

VerifyCardOnly

 

verifies the card only without posting the transaction

Optional

 

verifycardonly=false

 

Boolean

 

ManualAuthorization

 





ManualApprovalCode

 





AuthorizeOnly

 

Can be used in Testing

 

Optional

 

authorizeo   nly=true

 

Boolean

 

CardSwiped

 

 

 

If the credit card is present. Default is false. only provided for use if needed in in non-internet transactions

 

Optional

 

cardswiped=false

 

 

 

Boolean

 

 

 

UseCID

 

 

 

 

 

Uses the extra information on the back of the card for verfification.

 

Default is TRUE to require this authorization

 

 

Optional

 

 

 

 

usecid=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.

 

Required

 

 

 

 

 

 



VerifyCardOnly

 


Optional

 

VerifyCardOnly=true

 

Boolean

Credit

 

If true will issue a credit

 

Optional

 

credit=true

 

Boolean

 





















 

 

Outputs

Parameter

Description

Required

Example

Data Type

ResponseCode




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>