CashServices redirect deposits (Servipag, WebPay, BankTransfer)

Servipag is an online local payment provider which offers deposit payment solutions through different banks and retail stores throughout Chile. Their website processes payments of various types of merchants: Cell phone companies, Utilities, Satellite TV, schools, etc. Customer processes payments through either an account or a credit card.

Webpay is the payment portal of Transbank. A method by which credit and debit card transactions of all banks in Chile are processed. Webpay provides merchants with POS machines and payment API for online purchasing. Once implemented in merchant website, Webpay permits customers to pay through:
Debit card: All debit cards emitted by Chilean banks
Credit card: Visa, MasterCard, MAGNA, AMEX, DINERS (both National & International).

Local Bank Transfer is a payment method that is characterized by its security. It works for both face-to-face and electronic transfers. The customer has to make a deposit in any banking institution in Chile. Funds will be charged to the user's account within 1 business day.

The following method IDs are covered in this section:

ID

Name

Credit/Debit State

275

ServipagDeposit

DepositedByProvider(29)

276

WebPayDeposit

DepositedByProvider(29)

278

CashServicesBankTransferDeposit

DepositedByProvider(29)

Payment method interaction type: Redirection to External Payment Provider (see Interaction Types).
After choosing the payment method on merchant's site the user is redirected to the provider's site and without showing any screen to the user it redirects him to Servipag/WebPay site. There the payment is executed. The provider sends notification for successful or refused payment.

Redirect Integration

Currently not supported.

Backend2BackendIntegration

The following table contains the fields to be sent in the initiatePaymentRequest.xml and have special format:

key (value type, account type, required)

value

userID (string, required)

The Sportingbet client ID. Must be numeric (no points or commas are allowed)

amount (long integer, required)

Deposit amount. Must be numeric (no decimal places are allowed for the Chilean pesos)

The following parameters have to be provided in the initiatePaymentRequest.userData xml section:

key (value type, account type, required)

value

identificationNumber (string, required)

The user’s identification number. Must be 7 or 8 numbers followed by a hyphen (-) followed by a digit from 0 to 9 or a K.

email (string)

The user’s email address

UserFirstname (string)

The user´s first name

UserLastname (string)

The user´s last name

username (string)

The user´s username

Example initiatePaymentRequest:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <merchantID>MyMerchantID</merchantID>
    <shopID>MyShopID</shopID>
    <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>    
    <paymentMethodID>275</paymentMethodID>
    <amount currencyCode="CLP">10000</amount>                                              
    <userID>6895456</userID>
    <userData>
        <username>bz_t1test2test3test4test5test6</username>
        <firstname>Marcos Ignacio</firstname>
        <lastname>Perez Guevara</lastname>
        <email>[email protected]</email>
        <identificationNumber>76149769-k</identificationNumber>                             
    </userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>0bde6d65-1c02-42c8-9a4f-149f2c5779fc</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>HomePageUrl</key>
            <value>http://home/?a=b&amp;c=d</value>
        </data>
    </specificPaymentData>
</initiatePaymentRequest>
<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <merchantID>MyMerchantID</merchantID>
    <shopID>MyShopID</shopID>
    <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>    
    <paymentMethodID>276</paymentMethodID>
    <amount currencyCode="CLP">10000</amount>                                              
    <userID>6895456</userID>
    <userData>
        <username>bz_t1test2test3test4test5test6</username>
        <firstname>Marcos Ignacio</firstname>
        <lastname>Perez Guevara</lastname>
        <email>[email protected]</email>
        <identificationNumber>76149769-k</identificationNumber>                             
    </userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>0bde6d65-1c02-42c8-9a4f-149f2c5779fc</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>HomePageUrl</key>
            <value>http://home/?a=b&amp;c=d</value>
        </data>
    </specificPaymentData>
</initiatePaymentRequest>
<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <merchantID>MyMerchantID</merchantID>
    <shopID>MyShopID</shopID>
    <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>    
    <paymentMethodID>278</paymentMethodID>
    <amount currencyCode="CLP">10000</amount>                                              
    <userID>6895456</userID>
    <userData>
        <username>bz_t1test2test3test4test5test6</username>
        <firstname>Marcos Ignacio</firstname>
        <lastname>Perez Guevara</lastname>
        <email>[email protected]</email>
        <identificationNumber>76149769-k</identificationNumber>                             
    </userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>0bde6d65-1c02-42c8-9a4f-149f2c5779fc</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>HomePageUrl</key>
            <value>http://home/?a=b&amp;c=d</value>
        </data>
    </specificPaymentData>
</initiatePaymentRequest>

Example initiatePaymentResponse:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>275</key>
            <value>ServipagDeposit</value>
        </paymentMethod>
        <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>
        <paymentID>140ed053-16af-4ae8-8e6f-6f56be47d9cb</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">10000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>effd8564-cde9-4dfa-9b95-e4816abd051e</id>
            <definition>
                <key>30</key>
                <value>RedirectURLCreated</value>
            </definition>
            <createdOn>2017-09-19T09:21:11.8709727Z</createdOn>
            <description>[[The URL to redirect the customer to]]
</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>RedirectionUrl</key>
                    <value>[[The URL to redirect the customer to]]
</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">13.49</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>21088067</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>0</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>276</key>
            <value>WebPayDeposit</value>
        </paymentMethod>
        <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>
        <paymentID>140ed053-16af-4ae8-8e6f-6f56be47d9cb</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">10000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>effd8564-cde9-4dfa-9b95-e4816abd051e</id>
            <definition>
                <key>30</key>
                <value>RedirectURLCreated</value>
            </definition>
            <createdOn>2017-09-19T09:21:11.8709727Z</createdOn>
            <description>[[The URL to redirect the customer to]]
</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>RedirectionUrl</key>
                    <value>[[The URL to redirect the customer to]]
</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">13.49</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>21088067</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>0</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>278</key>
            <value>CashServicesBankTransferDeposit</value>
        </paymentMethod>
        <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>
        <paymentID>140ed053-16af-4ae8-8e6f-6f56be47d9cb</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">10000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>effd8564-cde9-4dfa-9b95-e4816abd051e</id>
            <definition>
                <key>30</key>
                <value>RedirectURLCreated</value>
            </definition>
            <createdOn>2017-09-19T09:21:11.8709727Z</createdOn>
            <description>[[The URL to redirect the customer to]]
</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>RedirectionUrl</key>
                    <value>[[The URL to redirect the customer to]]
</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">13.49</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>21088067</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>0</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Notifications

The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.

The provider notifies PXP Financial on payments that are either Successful (state DepositedByProvider) or Declined (state RefusedByProvider).

DepositedByProvider

Success state

RefusedByProvider

Payment has been rejected by the provider.

Example handlePaymentStateChangedNotificationRequest:

<?xml version="1.0" encoding="utf-16"?>
<handlePaymentStateChangedNotificationRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>275</key>
            <value>ServipagDeposit</value>
        </paymentMethod>
        <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>
        <paymentID>140ed053-16af-4ae8-8e6f-6f56be47d9cb</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">10000.0000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>effd8564-cde9-4dfa-9b95-e4816abd051e</id>
            <definition>
                <key>30</key>
                <value>DepositedByProvider</value>
            </definition>
            <createdOn>2017-09-19T09:21:11.87</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyIntValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">13.4900</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>21088067</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>6147141</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>0</paymentAccountID>
        </paymentAccount>
    </payment>
</handlePaymentStateChangedNotificationRequest>
<?xml version="1.0" encoding="utf-16"?>
<handlePaymentStateChangedNotificationRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>276</key>
            <value>WebPayDeposit</value>
        </paymentMethod>
        <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>
        <paymentID>140ed053-16af-4ae8-8e6f-6f56be47d9cb</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">10000.0000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>effd8564-cde9-4dfa-9b95-e4816abd051e</id>
            <definition>
                <key>30</key>
                <value>DepositedByProvider</value>
            </definition>
            <createdOn>2017-09-19T09:21:11.87</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyIntValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">13.4900</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>21088067</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>6147141</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>0</paymentAccountID>
        </paymentAccount>
    </payment>
</handlePaymentStateChangedNotificationRequest>
<?xml version="1.0" encoding="utf-16"?>
<handlePaymentStateChangedNotificationRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>278</key>
            <value>CashServicesBankTransferDeposit</value>
        </paymentMethod>
        <merchantTransactionID>h10fl2d7-trt5-te64-t7t9-wte6c1b3557a</merchantTransactionID>
        <paymentID>140ed053-16af-4ae8-8e6f-6f56be47d9cb</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">10000.0000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>effd8564-cde9-4dfa-9b95-e4816abd051e</id>
            <definition>
                <key>30</key>
                <value>DepositedByProvider</value>
            </definition>
            <createdOn>2017-09-19T09:21:11.87</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyIntValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">13.4900</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>21088067</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>6147141</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>0</paymentAccountID>
        </paymentAccount>
    </payment>
</handlePaymentStateChangedNotificationRequest>