Visa¶

Design. Build. Deliver. Open up a new world of possibilities for your business with direct access to Visa’s APIs, tools and expertise.

Website: developer.visa.com

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the developer.visa.com → Contact Us or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials¶

Credentials that have to be issued:

visanetconnect__user_id → User ID
isanetconnect__password → Password
visanetconnect__client_id → Client ID
visanetconnect__acceptor_id → Acceptor ID
visanetconnect__terminal_id → Terminal ID
visanetconnect__ssl_cert → SSL Certificate
visanetconnect__ssl_private_key → SSL Private Key
visanetconnect__mle_key_id → MLE Key ID
visanetconnect__mle_server_cert →MLE Server Certificate
visanetconnect__mle_private_key → MLE Private Key
visanetconnect__cb_org_id → Cybersource Org ID
visanetconnect__cb_key → Cybersource Key
visanetconnect__cb_shared_secret → Cybersource Shared Secret
visanetconnect__test_mode → Test mode
visanetconnect__currency → Currency → choose currency (You can set these parameters according to available currencies and features for your Visa wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Connect Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

Press Connect at Visa Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Connect

Enter credentials:

User ID
Password
Client ID
Acceptor ID
Terminal ID
SSL Certificate
SSL Private Key
MLE Key ID
MLE Server Certificate
MLE Private Key
Cybersource Org ID
Cybersource Key
Cybersource Shared Secret
Test mode → true/false

Success

You have connected Visa H2H merchant account!

API examples:¶

Minimum data set to create a payment invoices for payment_card_uah_hpp service¶

SALE
AUTH
non3DS

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_uah_hpp",
      "commerce_account":"Hello_World",
      "currency":"UAH",
      "amount":50,
      "flow":"delayed_charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":false
        }
      },
      "customer":{
        "reference_id":"d57fe234-1b7d-46e6-9941-bec47f4ba411",
        "address":{
          "post_code":"10001"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false,
        "delayed_action_delay":60,
        "delayed_action":"capture"
      },
      "reference_id":"c7513313-648f-422d-b17d-8884606f22c3",
      "service_fields":[
      ]
    }
  }
}

Maximum data set to create a payment invoices for payment_card_uah_hpp service¶

SALE
non3DS

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_uah_hpp",
      "commerce_account":"Hello_World",
      "currency":"UAH",
      "amount":100,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":false
        }
      },
      "customer":{
        "reference_id":"c64ef3c1-dc16-4825-9c6b-92616fea8a76",
        "address":{
          "full_address":"1 Shevchenka street",
          "post_code":"10001"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"eaae7030-186d-4269-a33e-6babcce19f37",
      "service_fields":[
      ]
    }
  }
}

Minimum data set to create a payment invoices for payment_card_uah_hpp service¶

SALE
3DS

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_uah_hpp",
      "commerce_account":"Hello_World",
      "currency":"UAH",
      "amount":100,
      "flow":"delayed_charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":false
        }
      },
      "customer":{
        "reference_id":"b84dbf31-6764-49d6-a06c-9848bcbc83a5",
        "name":"John Doe",
        "email":"[email protected]",
        "phone":"+380665544332",
        "address":{
          "country":"US",
          "city":"LA",
          "street":"Some street",
          "post_code":"94111"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false,
        "delayed_action_delay":60,
        "delayed_action":"capture"
      },
      "reference_id":"35584634-020c-475f-b6ed-09aa656f3564",
      "service_fields":[
      ]
    }
  }
}

Maximum data set to create a payment invoices for payment_card_uah_hpp service¶

SALE
3DS

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_uah_hpp",
      "commerce_account":"Hello_World",
      "currency":"UAH",
      "amount":100,
      "flow":"delayed_charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":false
        }
      },
      "customer":{
        "reference_id":"b84dbf31-6764-49d6-a06c-9848bcbc83a5",
        "name":"John Doe",
        "email":"[email protected]",
        "phone":"+380665544332",
        "address":{
          "country":"US",
          "region":"CA",
          "city":"LA",
          "street":"Some street",
          "post_code":"94111"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false,
        "delayed_action_delay":60,
        "delayed_action":"capture"
      },
      "reference_id":"35584634-020c-475f-b6ed-09aa656f3564",
      "service_fields":[
      ]
    }
  }
}

Constants¶

Сonstants

If some parameters are not sent in the transaction creation request, they will take the values from the set constants.

Here is a list of constants with their corresponding parameters:

FIRST_NAME → customer [first_name]
LAST_NAME → customer [last_name]
PHONE → customer [phone]
EMAIL → customer [email]
ADDRESS → customer [address] [address]
POST_CODE → customer [address] [post_code]
CITY → customer [address] [city]
COUNTRY → customer [address] [country]

Provider Options¶

Provider_Options

Use original ID in void
- using original ID for void request
  - /acs/v3/payments/sales/305079538527706/voids

Question

"Still looking for help connecting your Visa account?" Please contact our support team!