XMLRPC

[SECPay services]
-> [XMLRPC index]
-> Realtime Transactions

Realtime Transactions

Method Name: SECVPN.validateCardFull

PARAMETER EXAMPLE DEFINITION

mid secpay This is your secpay username (usually six letters and two numbers).

vpn_pswd secpay Your VPN password can be set from within the Merchant Extranet: https://www.secpay.com/secnet/logon.html. (Click on "Account" then "Remote Passwords" and select VPN from the drop down list).

trans_id TRAN0001 A unique transaction identifier created by yourself. This can be used to refer to a transaction at a later date (to refund it for example).

ip 127.0.0.1 The IP address that the cardholders machine is presenting to the internet.

name Mr Cardholder The cardholders name as it is on their card.

card_number 4444333322221111 The credit card number (this should contain no spaces or hyphens). The example card number show to the left is a test Visa card which can be used during development. Any valid expiry date which is in the future can be used with this card number.

amount 50.00 The amount for the transaction. This should contain no currency symbols or formatting (for example do not send an amount with a comma in).

expiry_date 0105 The credit card expiry date. Should be formatted either as mm/yy or mmyy.

issue_number 3 The credit card issue number. This only applies to switch or solo cards. If the card in use does not have an issue number then an empty string should be passed in.

start_date 0102 The credit card start date. If the card does not have a start date then an empty string should used.

order
prod=funny_book,item_amount=18.50x1;prod=sad_book,item_amount=16.50x2
Used to submit order details relevant to this transaction. Please see the User Manual for further details: http://www.secpay.com/sc_api.html#order.

shipping
name=Fred Bloggs,company=Online Shop Ltd,addr_1=Dotcom House,addr_2=London Road,city=Townville,state=Countyshire,post_code=AB1 C23,tel=01234 567890,fax=09876 543210,email=somebody@secpay.com,url=http://www.somedomain.com
Used to submit shipping address details relevant to this transaction. Please see the User Manual for further details: http://www.secpay.com/sc_api.html#shipping.

billing
name=Fred Bloggs,company=Online Shop Ltd,addr_1=Dotcom House,addr_2=London Road,city=Townville,state=Countyshire,post_code=AB1 C23,tel=01234 567890,fax=09876 543210,email=somebody@secpay.com,url=http://www.somedomain.com
Used to submit billing address details relevant to this transaction. Please see the User Manual for further details: http://www.secpay.com/sc_api.html#billing.

options
test_status=true,dups=false,card_type=Visa
Used to submit optional parameters which are used to alter the behaviour of this transaction. Please see the User Manual for further details: http://www.secpay.com/sc_api.html#other.

Example XMLRPC Request...

<?xml version="1.0"?>
    <methodCall>
    <methodName>SECVPN.validateCardFull</methodName>
    <params>
        <param>
            <value><string>secpay</string></value>
        </param>
        <param>
            <value><string>secpay</string></value>
        </param>
        <param>
            <value><string>trans_id</string></value>
        </param>
        <param>
            <value><string>192.168.1.1</string></value>
        </param>
        <param>
            <value><string>Mr Joseph Bloggs</string></value>
        </param>
        <param>
            <value><string>4444333322221111</string></value>
        </param>
        <param>
            <value><string>10.51</string></value>
        </param>
        <param>
            <value><string>12/06</string></value>
        </param>
        <param>
            <value><string></string></value>
        </param>
        <param>
            <value><string></string></value>
        </param>
        <param>
            <value><string></string></value>
        </param>
        <param>
            <value><string></string></value>
        </param>
        <param>
            <value><string></string></value>
        </param>
        <param>
            <value><string>test_status=true,dups=false</string></value>
        </param>
    </params>
</methodCall>

Example XMLRPC Response...

<?xml version="1.0" encoding="ISO-8859-1"?>
    <methodResponse>
    <params>
        <param>
            <value>
                ?valid=true&trans_id=trans_id&code=A&auth_code=9999&
                message=TEST AUTH&amount=10.51&test_status=true
            </value>
        </param>
    </params>
</methodResponse>