Visa

Visa is a supported Cayan credit card payment method that is used for transactions during the sales order workflow. Visa is included by default in the payment pick list. It isn't set as a CustomCharge.

Before you can use payment processors and their supported payment methods for transactions during the sales order workflow, configuration is required in Order Management.

The order XML or order JSON is imported into Order Management with the payment tag when the payment is Authorized or Captured outside of Order Management. When tokenization is enabled, the bfProcessorToken custom attribute is included in the XML. The Secure Storage Enabled field is configured for tokenization in the Cayan External Payment Processors.

Example 1: Payment Tag in XML

This example shows the payment tag in XML when tokenization is set to 'No' in Order Management, the <card-type> = VISA and the <transaction-type> = AUTH.

Note: When the tokenization is set to 'No' for a Captured payment transaction, the XML is the same except that the <transaction-type> = CAPTURE.
<payments>
   <payment>
      <credit-card>
         <card-type>VISA</card-type>
         <card-number>XXXX-XXXX-XXXX-8876</card-number>
         <expiration-month>01</expiration-month>
         <expiration-year>2025</expiration-year>
     </credit-card>
     <amount>25.98</amount>
     <processor-id>Cayan</processor-id>
     <transaction-id>255694669</transaction-id>
     <transaction-type>AUTH</transaction-type>
   </payment>
</payments>

Example 2: Custom Attributes Added to the Payment Tag in XML

This example shows the payment tag in XML when the tokenization is set to 'Yes' in Order Management, the <card-type> = VISA, the <transaction-type> = AUTH, and the <custom-attribute attribute-id> ="bfProcessorToken">XXXXX. The XXXXX refers to the token's string of numbers.

Note: When tokenization is set to 'Yes' for a Captured payment transaction, the XML is the same except that the transaction-type = CAPTURE.
<payments>
   <payment>
      <credit-card>
         <card-type>VISA</card-type>
         <card-number>XXXX-XXXX-XXXX-8876</card-number>
         <expiration-month>01</expiration-month>
         <expiration-year>2025</expiration-year>
      </credit-card>
      <amount>25.98</amount>
      <processor-id>Cayan</processor-id>
      <transaction-id>255694669</transaction-id>
      <transaction-type>AUTH</transaction-type>
      <custom-attributes>
      <custom-attribute attribute-id="bfProcessorToken">998974312</custom-attribute>
	     </custom-attributes>
   </payment>
</payments>

Example 3: Payment Tag in JSON

This example shows the payment tag in JSON when the tokenization is set to 'Yes' in Order Management, the "processor_id" = "Cayan", the "payment_method" = "Visa", the "service_transaction_id> = 1003572739, the 'type: = "AUTH", and "name" ="bfProcessorToken" with a "string_value" = XXXXX. The XXXXX refers to the token's string of numbers.

Note: When tokenization is set to 'Yes' for a captured payment transaction, 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": "Visa", 
            "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": "1003572739",
                    "amount_code": "EUR",
                    "amount_value": 10.00,
                    "description": null,
                    "payment_processor_id": "bcnWEiaage3MQaaade8cFZMFRd",
                    "payment_instrument_info_id": "ab4d479b648d78ed47c30dd751",
                    "type": "AUTH", 
                    "record": null,
                    "invoice_number": null,
                    "order_payment_instrument_po":
                    { "$ref": 13 }
                  , {
                        "owner_id": "61dc90e970358f77f6e75b1a1c",
                        "name": "authAmount",
                        "context_id": "default",
                        "idx": 0,
                        "localized_flag": false,
                        "type": 3,
                        "int_value": null,
                        "double_value": null,
                        "string_value": "19.59",
                        "text_value": null,
                        "date_value": null,
                        "oca": 325516093,
                        "last_modified": "2017-04-25T13:08:13.665Z",
                        "owner":
                        { "$ref": 14 }
                    }, {
                        "owner_id": "61dc90e970358f77f6e75b1a1c",
                        "name": "bfProcessorToken",
                        "context_id": "default",
                        "idx": 0,
                        "localized_flag": false,
                        "type": 3,
                        "int_value": null,
                        "double_value": null,
                        "string_value": "998974312",

                        "text_value": null,
                        "date_value": null,
                        "oca": 325516093,
                        "last_modified": "2017-04-25T13:08:13.678Z",
                        "owner":
                        { "$ref": 14 }
                    },],
                    "processor_id": "CAYAN"

                }],