Visa Checkout

Visa Checkout is a supported CyberSource mobile payment method that is used for transactions during the sales order workflow. VisaCheckout can be set as a CustomCharge payment method in the Payment Methods. For example, Visa Checkout can be configured as CustomChargeX, where X can be a number between 1-15.

When using the CyberSource Gateway API for Visa Checkout, Visa Checkout payment method must be enabled in the CyberSource merchant account. Once enabled for Visa Checkout, an API key, which is required to perform Auth/Sale transactions, is generated.
Note: Configure the external processor, CyberSource 2.1 Account. Before you can use a payment processor and its supported payment methods, configuration is required in Order Management. The following fields are mandatory:
  • Label: Name of the payment processor
  • DecisionManagerEnabled: Enables or disables the CyberSource Decision Manager in the merchant account
  • ID: the merchant ID for the CyberSource merchant account
  • SecureStorageEnabled: Enables or disables tokenization
  • TransactionKey: The security key for the SOAP Toolkit API, which is available from the Management Transaction Security Keys tab in the merchant account.
  • MultiCapture: Set to Yes to support multi-capture. Default is No.
Configure the custom attributes, vcOrderID, and paymentSolution. Note the following settings in Order Management Administration: Settings > Preferences > Attributes
  • Select the Payments group.
  • Enter the custom attribute, vcOrderID, in the ID field.
  • To map the custom attribute in the JSON order XML to the custom attribute name in the database, enter the proper tag value.
  • Attach to the Order and Payment Objects. Select Order and Payment from the dropdown list.
  • Repeat these steps for the paymentSolution custom attribute.
Note: When setting up the Cybersource merchant account, https://www.cybersource.com/developers/integration_methods/visa_checkout/, note the following:
  • From the home page, click Account Management > Digital Payment Solutions.
  • Click Sign Up for Visa Checkout, verify your account information, accept the Visa Checkout Merchant Services Agreement, and create an account.
  • The CyberSource merchant account then generates the Visa Checkout API key that is used in Order Management.
The processor features enabled for Visa Checkout are as follows:
Processor OM & First Data Global Gateway v3 Integration Comments
Type Payment Gateway https://www.cybersource.com/
Auth/Capture Yes Order Management receives successfully authorized imported orders from Salesforce B2C Commerce. Capture and other transactions, such as Refund, Void can then be performed.
Sale Yes Order Management receives successfully captured imported orders from B2C Commerce. Other transactions, such as Refund, Void can be performed later.
Void Yes A Void transaction is supported an Auth, Sale, and Capture transaction.
Credit No  
Refund Yes  
Multi-Currency Yes Accepts payments in multiple currencies.
Multi-Capture Yes Multi-Capture enables the captured transactions in cases of multiple shipment orders.
Tokenization No  
Split Payments No  

Example: Payment Tag in JSON

Here is a sample JSON order that uses the Salesforce B2C Commerce - Order Management integration. Note the following payment tags:

Note: If an order is created with a decision, add the bfDecisionaManager tag or bfResponseData tag. Noth tags cannot be included in single order JSON.

The JSON is the same except that the transaction-type = CAPTURE.

"order_payment_instrument_pos": [{
            "$id": 13,
            "uuid": "ab4d479b648d78ed47c30dd751",
            "domain_id": "bcC4kiaageA2MaaadehslZMFRd",
            "oca": 325516093,
            "creation_date": "2017-04-25T13:08:12.654Z",
            "last_modified": "2017-04-25T13:08:13.677Z",
            "payment_method": "visacheckout", 
            "ek_id": 42785,
            "bank_account_drivers_license_state_code": null,
            "bank_account_holder": null,
            "encrypted_bank_account_number": null,
            "bank_routing_number": null,
            "encrypted_bank_account_drivers_license": null,
            "gift_certificate_id": null,
            "creditcard_token": null,
            "line_item_ctnr_id": "f5adee1ab5bcab285ef453e03f",
            "order_po":
            { "$ref": 0 } ,
                "order_payment_transaction_pos": [{
                    "$id": 14,
                    "uuid": "61dc90e970358f77f6e75b1a1c",
                    "domain_id": "bcC4kiaageA2MaaadehslZMFRd",
                    "oca": 325516096,
                    "creation_date": "2017-04-25T13:08:12.654Z",
                    "last_modified": "2017-04-25T13:08:13.678Z",
                    "status": 0,
                    "service_transaction_id": "5216152530226361604011",
                    "amount_code": "EUR",
                    "amount_value": 10.00,
                    "description": null,
                    "payment_processor_id": "bcnWEiaage3MQaaade8cFZMFRd",
                    "payment_instrument_info_id": "ab4d479b648d78ed47c30dd751",
                    "type": "CAPTURE", 
                    "record": null,
                    "invoice_number": null,
                    "order_payment_instrument_po":
                    { "$ref": 13 }
                  ,   "attribute_values": [ {
                        "owner_id": "61dc90e970358f77f6e75b1a1c",
                        "name": "paymentSolution",
                        "context_id": "default",
                        "idx": 0,
                        "localized_flag": false,
                        "type": 3,
                        "int_value": null,
                        "double_value": null,
                        "string_value": "visacheckout", 
                        "text_value": null,
                        "date_value": null,
                        "oca": 325516093,
                        "last_modified": "2017-04-25T13:08:13.666Z",
                        "owner":
                        { "$ref": 14 }
                    }, {
                        "owner_id": "61dc90e970358f77f6e75b1a1c",
                        "name": "vcOrderID",
                        "context_id": "default",
                        "idx": 0,
                        "localized_flag": false,
                        "type": 3,
                        "int_value": null,
                        "double_value": null,
                        "string_value": "3592124726078766202", 
                        "text_value": null,
                        "date_value": null,
                        "oca": 325516093,
                        "last_modified": "2017-04-25T13:08:13.666Z",
                        "owner":

                        { "$ref": 14 }
                    },{
                        "owner_id": "61dc90e970358f77f6e75b1a1c",
                        "name": "bfDecisionManager", 
                        "context_id": "default",
                        "idx": 0,
                        "localized_flag": false,
                        "type": 3,
                        "int_value": null,
                        "double_value": null,
                        "string_value": "<![CDATA[<CyberSourceDecisionManagerResponse>\n <MerchantReferenceCode>00099803</MerchantReferenceCode>\n <RequestId>5217183129716580604009</RequestId>\n <ReasonCode>100</ReasonCode>\n <Decision>ACCEPT</Decision>\n <AfsResult>16</AfsResult>\n <AfsFactorCode/>\n <BinCountry/>\n <IpCountry/>\n <IpCity/>\n <IpState/>\n <IpRoutingMethod/>\n <DeviceFingerprint>\n <CookiesEnabled/>\n <FlashEnabled/>\n <Hash/>\n <ImagesEnabled/>\n <JavascriptEnabled/>\n <ProxyIPAddress/>\n <ProxyIPAddressActivities/>\n <ProxyIPAddressAttributes/>\n <ProxyServerType/>\n <TrueIPAddress/>\n <TrueIPAddressActivities/>\n <TrueIPAddressAttributes/>\n <TrueIPAddressCity/>\n <TrueIPAddressCountry/>\n </DeviceFingerprint>\n <RulesTriggered>\n <RuleResultItem>\n <Name/>\n <Decision/>\n <Evaluation/>\n <RuleID/>\n </RuleResultItem>\n </RulesTriggered>\n</CyberSourceDecisionManagerResponse>]]>",
                        "text_value": null,
                        "date_value": null,
                        "oca": 325516093,
                        "last_modified": "2017-04-25T13:08:13.674Z",
                        "owner":
                        { "$ref": 14 }
                    },
      {
                        "owner_id": "61dc90e970358f77f6e75b1a1c",
                        "name": "bfResponseData",  
                       "context_id": "default",
                        "idx": 0,
                        "localized_flag": false,
                        "type": 3,
                        "int_value": null,
                        "double_value": null,
                        "string_value": 
                        "<?xml version=\"1.0\" encoding=\"utf-16\"?>
                        <ReplyMessage xmlns: xsi =\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\">
                        <merchantReferenceCode xmlns =\"urn:schemas-cybersource-com:transaction-data-1.129\">TEST-4224
                        </merchantReferenceCode>
                        <requestID xmlns =\"urn:schemas-cybersource-com:transaction-data-1.129\">5216152530226361604011
                        </requestID>
                        <decision xmlns =\"urn:schemas-cybersource-com:transaction-data-1.129\">ACCEPT</decision>

                        <reasonCode xmlns =\"urn:schemas-cybersource-com:transaction-data-1.129\">100</reasonCode>
                        <requestToken xmlns =\"urn:schemas-cybersource-com:transaction-data-1.129\">
                        Ahj/7wSTGsSoceFdSxerESDdg4ZNG7Fqyi0YLWlOaKNPkUgYXAVGnyKQML6QL9O/HwyaSZbpAduOBBhJjWJUOPCupYvVgAAAnxxp</requestToken>
                        <purchaseTotals xmlns =\"urn:schemas-cybersource-com:transaction-data-1.129\">
                        <currency>USD</currency>
                        </purchaseTotals>
                        <ccAuthReply xmlns =\"urn:schemas-cybersource-com:transaction-data-1.129\">
                        <reasonCode>100</reasonCode>
                        <amount>19.59</amount>
                        <authorizationCode>888888</authorizationCode>
                        <avsCode>X</avsCode>
                        <avsCodeRaw>I1</avsCodeRaw>
                        <authorizedDateTime>2018 - 03 - 07T06: 58:30Z</authorizedDateTime>
                        <processorResponse>100</processorResponse>
                        <reconciliationID>708247152EQA5RN4</reconciliationID>
                        </ccAuthReply></ReplyMessage>",
                        "text_value": null,
                        "date_value": null,
                        "oca": 325516093,
                        "last_modified": "2018-03-21T12:24:16.5974797+05:30",
                        "owner": {
                      "$ref": 14
                        }
                    }],
                    "processor_id": "CYBERSOURCE_CREDIT"
                }],
X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. By continuing to use this site you are giving us your consent to do this.