Supported Functionality

❗️
IP Address Requirements
CCBill only accepts IPv4.
IPv6 will result in a decline.

Adding a CCBill Merchant

To connect a Merchant using CCBill Gateway,

First add Merchant
Select CCBill as the Gateway
Add Gateway Details as outlined below

*Required

Request Data Mapping

Below is a table that will show how Vrio maps its data to the requested payment gateway API. Values in bold are hard coded values, the rest are dynamic based on the payment.

To generate the token

CCBill	Vrio
subscriptionId	0
customerInfo.address1	Billing Address Line 1
customerInfo.address2	Billing Address Line 2
customerInfo.city	Billing City
customerInfo.country	Billing Country
customerInfo.customerFname	Billing First Name
customerInfo.customerLname	Billing Last Name
customerInfo.email	Customer Email
customerInfo.ipAddress	Ip Address
customerInfo.phoneNumber	Billing Telephone
customerInfo.state	Billing State
customerInfo.zipcode	Billing Postal Code
paymentInfo.creditCardPaymentInfo.cardNum	customers_card.card_number
paymentInfo.creditCardPaymentInfo.cardNum	Billing First Name & Last Name
paymentInfo.creditCardPaymentInfo.expMonth	customers_card.card_exp_month
paymentInfo.creditCardPaymentInfo.expYear	customers_card.card_exp_year
paymentInfo.creditCardPaymentInfo.cvv2	customers_card.card_cvv

To Create the Transaction

3DS Fields (when creating transaction)

CCBill	Vrio
threedsEci	orders_3ds.order_eci
threedsSuccess	true if orders_3d.order_cardholder_auth = “y”
threedsXid	orders_3ds.order_xid
threedsCavv	orders_3ds.order_cavv
threedsVersion	orders_3ds.order_3ds_version
threedsDsTransId	orders_3ds.order_3ds_ds_transaction_id

Response Data Mapping

Below is a table that will show how Vrio maps its data in the API response


paymentUniqueId	Gateway Response ID
subscriptionId	Gateway Response Gateway ID
sessionId	Gateway Auth Code
cvv2Response	Gateway Response CVV Code
avsResponse	Gateway Response AVS Code
paymentTokenId	Customer Card Merchant Token
errorCode	Gateway Response Code
errors or generalMessage	Message

Common Errors

IPv6 is being used - not accepted by CCBill.
CCBill has validation - numbers within a name are not accepted by CCBill

See all of the CCBill Errors here.

Testing

Note: Placing test orders with a CCBill sandbox account or CCBill test cards will not automatically set the order as a test in Vrio. Be sure to flag the order as a test using the is_test flag after the order is processed. For more details on placing test orders, click here.

For CCBill test cards, check here