transaction.create
Updated 1,722 Days AgoPublic
Actions

Version 10 of 14: You are viewing an older version of this document, as it appeared on Aug 23 2019, 14:56.

transaction.create

Note: command is supported by all CC and mobile processors (RG, AR, NB, PO, RG, IO, GP).

Description

Initialize and finish transaction in one command

Input Parameters

Name	Type	Required	Description
pp_type	(string)	yes	Payment processor type
tracking_order	(int)	no	Order ID to be tracked on client app.
tracking_user	(int)	yes	User ID to be tracked on client app.
tracking_tag	(int)	yes	Tag ID to be tracked on client app.
first_name	(string)	yes	First Name
last_name	(string)	yes	Last Name
zipcode	(string)	yes	User ZIP code
country	(string)	yes	Country abbr.
email	(string)	yes	User email address
ip	(string)	yes	IP address from which user is making the transaction
host	(string)	yes	Host form which user is making the transaction
currency	(string)	yes	Currency abbr.
order_type	(string)	no	Allowed values '' (empty string) and `xsale`. Determine if order is Cross Sale or not.
initial_order_hash	(string)	no	Use only in case of order_type = 'xsale'. Put hash from transation.init response of initial/basic order
return_url	(string)	no	Return URL (used for PayPal like PP's)
cancel_url	(string)	no	Cancel URL (used for PayPal like PP's)
items	(array)	yes	Array of items
pp_config	(array)	no	Merchand data params to override
card_number	(string)	yes	Credit Card Number
transaction_id	(string)	no	Can be used instead of Credit Card for repeated billing transactions
card_cvv2	(string)	yes	Credit Card CVV2
card_expire	(string)	yes	Credit Card Expiration date
xsale-descriptor	(string)	no	Force descriptor value (XS only)
step_down	(int)	no	Force step down procedure (start immediately with stepped down price)
allow_step_down	(int)	no	Allow step down procedure (start immediately when 1st attempt fails - if possible)
merchant_order_number	(string)	*yes(GP)	GP only param
package_name	(string)	*yes(GP)	GP only param
purchase_token	(string)	*yes(GP)	GP only param
purchase_id	(string)	*yes(GP/IO)	GP and IO only param
receipt-data	(string)	*yes(IO)	IO only param

items

Name	Type	Required	Description
trial_amount	float	no	Trial Amount
trial_unit	string (day\|week\|month\|year)	no	Trial unit
trial_period	int	no	Trial period
amount	float	yes	rebill amount
rebill_unit	string (day\|week\|month\|year)	yes	rebill unit
rebill_period	int	yes	rebill period
max_rebill_count	int	yes	max rebill count (-1 unlimited)
description	string	yes	Item description

pp_config

Name	Type	Required	Description
ppac_id	int	no	Merchant account id (defined for partner in payment app)
force_acc	int	no	Rocket Gate specific, if set it will set appropriate merchantAccount parameter for API call to Rocket Gate
force_mid	int	no	Rocket Gate specific, if set it will set appropriate merchantSiteID parameter for API call to Rocket Gate

Return

Name	Type	Description
result	array	Result array with data

Usage Example

{
    "result": {
        "code": 700,
        "status": "Action completed successfully",
        "command": "transaction.create",
        "result": {
            "hash": "1554909890217532c2fe3c75da8275e3",
            "redirect": "",
            "success": true,
            "rg_avs_response": "",
            "rg_cvv2_code": "",
            "authNo": "422144",
            "merchantInvoiceID": "M1_4153916_49356",
            "merchantAccount": "2",
            "approvedAmount": "1.0",
            "cardLastFour": "1881",
            "version": "1.0",
            "merchantCustomerID": "M1_4153916",
            "reasonCode": "0",
            "retrievalNo": "100016a07da07af",
            "payType": "CREDIT",
            "cardHash": "3RPN+a+d07r0bOlq7NcWPKvzgcyyHmPxXw+hCxxmP6k=",
            "cardDebitCredit": "1",
            "cardDescription": "UNKNOWN",
            "cardCountry": "CA",
            "cardType": "VISA",
            "bankResponseCode": "0",
            "approvedCurrency": "PLN",
            "guidNo": "100016A07DA07AF",
            "cardExpiration": "0621",
            "responseCode": "0",
            "remote_tran_id": "100016A07DA07AF",
            "payment_tran_id": 298906,
            "rg_merchant_id": "1358984622",
            "rg_customer_id": "M1_4153916",
            "rg_reason_code": "0",
            "rg_guid_no": "100016A07DA07AF",
            "rg_cc_hash": "3RPN+a+d07r0bOlq7NcWPKvzgcyyHmPxXw+hCxxmP6k=",
            "items_data": [
                {
                    "item_id": "69312",
                    "tracking_item": "0"
                }
            ],
            "sub_ids": [
                36214
            ],
            "ppac_id": "74"
        },
        "request": {
            "cmd": "transaction.create",
            "data": {
                "tracking_user": "4153916",
                "tracking_tag": "14",
                "tracking_item": "13084",
                "first_name": "Jeremiah",
                "last_name": "Hawn",
                "street": "",
                "city": "",
                "state": "",
                "zipcode": "92691",
                "country": "US",
                "email": "xstest426@xstest426.net",
                "ip": "68.5.187.46",
                "host": "68.5.187.46",
                "currency": "PLN",
                "items": [
                    {
                        "amount": "1",
                        "description": "$1.00USD - 1 Month Premium Membership Access||13084",
                        "max_rebill_count": "1",
                        "rebill_unit": "day",
                        "rebill_period": "30",
                        "trial_period": "30",
                        "trial_amount": "1.00",
                        "trial_unit": "day"
                    }
                ],
                "pp_type": "RG",
                "transaction_id": "297634"
            },
            "token": "dating-frontend-m1@staging",
            "pass": "***"
        },
        "ts": 1554909890,
        "origin_ip": "69.61.68.253",
        "errors": null
    }
}