Cassette for BankServACH¿ë °è»ê¿ø ÇÁ·ÎÆÄÀÏ

´ÙÀ½ XML ÄÚµå´Â WebSphere Commerce¿¡¼­ BankServACH Ä«¼¼Æ®¿¡ ´ëÇØ »ç¿ëÇϵµ·Ï Á¦°øÇϴ ǥÁØ °è»ê¿ø ÇÁ·ÎÆÄÀÏÀÔ´Ï´Ù.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Profile SYSTEM "../../../../xml/PaymentManager/profile.dtd">

<!--
//*==================================================================
//* Licensed Materials - Property of IBM
//*
//* 5724-A18
//*
//* (c) Copyright IBM Corp. 2001
//*
//* US Government Users Restricted Rights - Use, duplication or
//* disclosure restricted by restricted by GSA ADP Schedule Contract with IBM Corp.
//*
//*================================================================== -->

<!-- ==================================================================
This is the Standard WebSphere Commerce cashier profile for the Payment Manager ACH Cassette for BankServ. (This Cassette is for US Only.)
================================================================== -->

<Profile useWallet="false" enableTrace="true" >

<CollectPayment>

<!-- ==================================================================
Parameters required by Payment Manager for order creation
================================================================== -->

<Parameter name="PAYMENTTYPE"><CharacterText>BankServACH</CharacterText></Parameter>

<Parameter name="MERCHANTNUMBER"><CharacterText>{storeId}</CharacterText></Parameter>
<Parameter name="ORDERNUMBER"><CharacterText>{orderId}</CharacterText></Parameter>
<Parameter name="CURRENCY"><CharacterText>{CURRENCY}</CharacterText></Parameter>
<Parameter name="AMOUNT"><CharacterText>{AMOUNT}</CharacterText></Parameter>
<Parameter name="AMOUNTEXP10"><CharacterText>{AMOUNTEXP10}</CharacterText></Parameter>

<!-- Indicates how automatic approval of the order should be attempted
Supported values are:
0 - no automatic approval
1 - synchronous automatic approval - Payment Manager attempts approval as
part of order creation operation
2 - asynchronous automatic approval - Payment Manager schedules an approval
operations after order is created

WCS works best with APPROVEFLAG set to 2. When the APPROVEFLAG is set to 1, the WCS 
DoPayment command is blocked until Payment Manager completes the approval of the order. 
Until this approval is complete, any commands wanting to read/update the same inventory 
records modified by the DoPayment command will be blocked. This will affect the throughput
of the other commands.
-->
<Parameter name="APPROVEFLAG"><CharacterText>2</CharacterText></Parameter>

<!-- The amount which should be used when approving an order. Usually
this will be the same as the order amount. This field is required
if the APPROVEFLAG is set to 1 or 2. -->
<Parameter name="PAYMENTAMOUNT"><CharacterText>{approval_amount}</CharacterText></Parameter>

<!-- The payment number which used be used when approving an order.
Usually this will be 1. This field is required if the APPROVEFLAG
is set to 1 or 2. -->
<Parameter name="PAYMENTNUMBER"><CharacterText>1</CharacterText></Parameter>

<!-- Indicates whether the deposit should be attempted automatically. 
This flag is only valid if APPROVEFLAG is set to 1 or 2.
Supported values are:
0 - Funds should not be automatically deposited. 
1 - Funds should be automatically deposited. 
The default value is 0.
-->
<Parameter name="DEPOSITFLAG"><CharacterText></CharacterText></Parameter>

<!-- ==================================================================
Optional parameters for Payment Manager
================================================================== -->

<!-- The following two parameters are optional. Either one could be used to pass the 
Buyer Purchase Order number to the Payment Manager. The first Parameter takes only 
ASCII Text. If Buyer Purchase Order numbers on your system may contain non-ASCII 
Strings, use parameter ORDERDATA2 instead. 
-->
<Parameter name="TRANSACTIONID" maxBytes="128" encoding="ASCII"><CharacterText>{PONumber}</CharacterText></Parameter>
<Parameter name="ORDERDATA2"><CharacterText></CharacterText></Parameter>

<!-- ==================================================================
Parameters required by the cassette
================================================================== -->
<!-- The checking account number -->
<Parameter name="$CHECKINGACCOUNTNUMBER"><CharacterText>{checkingAccountNumber}</CharacterText></Parameter>

<!-- The check routing number -->
<Parameter name="$CHECKROUTINGNUMBER"><CharacterText>{checkRoutingNumber}</CharacterText></Parameter>

<Parameter name="$BUYERNAME" maxBytes="80" encoding="ASCII"><CharacterText>{billto_firstname} {billto_lastname}</CharacterText></Parameter>
<Parameter name="$STREETADDRESS" maxBytes="50" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>
<Parameter name="$CITY" maxBytes="50" encoding="ASCII"><CharacterText>{billto_city}</CharacterText></Parameter>

<!-- Only the 2-character US State Codes in Uppercase (e.g. AL for Alabama, AK for Alaska, etc.) 
are accepted by the Cassette. The BankServACH Cashier Extension class is used to locate 
the 2-character State Code from the WebSphere Commerce STATEPROV Table using the value specified
in the {billto_state} environment variable as State name. The Cashier Extension returns null 
if no State Code can be found for the State name specified. For compatibility, the Extension 
class returns the {billto_state} environment variable value as the State code if the value is 
of length two.
-->
<Parameter name="$STATEPROVINCE" maxBytes="2" encoding="ASCII">
<ExtensionValue name="com.ibm.commerce.payment.extensions.BankServACHCashierExtension" />
</Parameter>
<Parameter name="$POSTALCODE" maxBytes="9" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>
<Parameter name="$COUNTRYCODE" maxBytes="2" encoding="ASCII"><CharacterText>US</CharacterText></Parameter>
<Parameter name="$PHONENUMBER" maxBytes="10" encoding="ASCII"><CharacterText>{billto_phone_number}</CharacterText></Parameter>

<!-- ==================================================================
Optional parameters for the CustomOffline Cassette
================================================================== -->
<Parameter name="$STREETADDRESS2" maxBytes="50" encoding="ASCII"><CharacterText></CharacterText></Parameter>
<Parameter name="$EMAILADDRESS" maxBytes="49" encoding="ASCII"><CharacterText></CharacterText></Parameter>

</CollectPayment>

<Command name="DEPOSIT">
<!-- ==================================================================
Parameters required by Payment Manager for DEPOSIT Command
================================================================== -->
<Parameter name="MERCHANTNUMBER"><CharacterText>{storeId}</CharacterText></Parameter>
<Parameter name="ORDERNUMBER"><CharacterText>{orderId}</CharacterText></Parameter>
<Parameter name="PAYMENTNUMBER"><CharacterText>{payment_number}</CharacterText></Parameter>
<Parameter name="AMOUNT"><CharacterText>{AMOUNT}</CharacterText></Parameter>

</Command>



</Profile>

WC51_BankServACH.profile ÇÁ·ÎÆÄÀÏÀº ´ÙÀ½ À§Ä¡¿¡ ÀÖ½À´Ï´Ù.
drive:\WebSphere\CommerceServer\instances\instance_name\xml\payment\
drive:\Program Files\WebSphere\CommerceServer\instances\instance_name\xml\payment\
/usr/WebSphere/CommerceServer/instances/instance_name/xml/payment/
/opt/WebSphere/CommerceServer/instances/instance_name/xml/payment/
instance root path/xml/payment/

¿©±â¼­ instance root path´Â ÀνºÅϽº ÀÛ¼º Áß¿¡ ±¸¼º °ü¸®ÀÚÀÇ ÀνºÅϽº ÆÐ³Î¿¡¼­ ÀνºÅϽº ·çÆ® °æ·Î Çʵ忡 ÁöÁ¤µÈ °æ·ÎÀÔ´Ï´Ù. ±âº» °æ·Î´Â /QIBM/UserData/WebCommerce/instances/instance_name/ÀÔ´Ï´Ù.

PAYMENTTYPE ¸Å°³º¯¼ö´Â ÀÌ ÇÁ·ÎÆÄÀÏ Ä«¼¼Æ®ÀÇ À̸§À» ÁöÁ¤ÇÕ´Ï´Ù.

WebSphere Commerce´Â °è»ê¿ø ÇÁ·ÎÆÄÀÏÀÇ <BuyPageInformation> ¿ä¼Ò¸¦ »ç¿ëÇÏÁö ¾Ê½À´Ï´Ù. µ¿µîÇÑ ±â´ÉÀÌ ÁöºÒ Á¤Ã¥ÀÇ attrPageName Ư¼º°ú ÇÔ²² Á¦°øµË´Ï´Ù.

ÀÌ °è»ê¿ø ÇÁ·ÎÆÄÀÏÀº BankServACHCashierExtensionÀ̶ó´Â CashierExtension Ŭ·¡½º¸¦ »ç¿ëÇÏ¿© Çʼö $STATEPROVINCE ¸Å°³º¯¼ö¿¡ ´ëÇÑ 2ÀÚ »óÅ Äڵ带 È®º¸ÇÕ´Ï´Ù. ÀÌ Å¬·¡½º´Â »óÅ À̸§À¸·Î {billto_state} ȯ°æ º¯¼ö¿¡ ÁöÁ¤µÈ °ªÀ» »ç¿ëÇÏ¿© STATEPROV Å×ÀÌºí¿¡¼­ »óÅ Äڵ带 ã½À´Ï´Ù. Ŭ·¡½º´Â ÁöÁ¤µÈ »óÅ À̸§¿¡ ´ëÇÑ »óÅ Äڵ带 ãÀ» ¼ö ¾ø´Â °æ¿ì ³Î(Null)°ªÀ» ¸®ÅÏÇÕ´Ï´Ù. ȣȯ¼ºÀ» À§ÇØ CashierExtensionÀº °ªÀÌ µÎ ¹®ÀÚÀÇ ±æÀÌÀÎ °æ¿ì »óÅ ÄÚµå·Î {billto_state} ȯ°æ º¯¼ö°ªÀ» ¸®ÅÏÇÕ´Ï´Ù.

{billto_state} ȯ°æ º¯¼ö ¹× ±âŸ {billto_*} ȯ°æ º¯¼ö´Â °è»ê¿ø collectPayment È£Ãâ¿¡ ´ëÇÑ ¸Å°³º¯¼ö·Î °è»ê¿ø¿¡ Àü´ÞµÈ À̸§ °ª ½ÖÀÇ ÀϺÎÀÔ´Ï´Ù. ÀÌ·¯ÇÑ º¯¼ö°ªÀº ADDRESS Å×À̺íÀÇ ÇØ´ç ¿­¿¡¼­ ³ª¿É´Ï´Ù.

¶Ç´Â ADDRESS Å×À̺íÀÇ STATE ¿­¿¡¸¸ °ªÀ¸·Î¼­ ¿Ã¹Ù¸¥ »óÅ À̸§ÀÌ ÀÖ´Ù´Â °ÍÀ» ¾Æ´Â °æ¿ì $STATEPROVINCE ¸Å°³º¯¼öÀÇ DatabaseValue¸¦ »ç¿ëÇÒ ¼ö ÀÖ½À´Ï´Ù. DatabaseValue¸¦ »ç¿ëÇÏ·Á¸é ´ÙÀ½ Áö½Ã»çÇ×À» ÂüÁ¶ÇϽʽÿÀ.

BankServACH Ä«¼¼Æ®¿¡ ÇÊ¿äÇÑ ¸Å°³º¯¼ö¿¡ ´ëÇÑ Ãß°¡ Á¤º¸´Â ¸ÖƼÇ÷§Æû¿ë IBM WebSphere Payment Manager, Cassette for BankServACH Supplement, Version 3.1À» ÂüÁ¶ÇϽʽÿÀ.

°ü·Ã °³³ä(1275¹ÙÀÌÆ®)

°ü·Ã °³³ä(1275¹ÙÀÌÆ®)

IBM copyright