Vendo¶

Bill better, grow more. INTELLIGENT PAYMENTS WITH A HUMAN TOUCH. Maximize revenue, minimize chargebacks and fraud, and keep customers coming back. Drive business forward.

Website: vendoservices.com

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the vendoservices.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:

vendo__site_id → Site ID
vendo__merchant_id → MID
vendo__secret_key → Shared Secret Key
vendo__gateway_api_secret_key → Gateway API Secret for Tests
vendo__test_mode → Test Mode
vendo_currency → choose currency (You can set these parameters according to available currencies and features for your Vendo 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 Vendo Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Connect

Enter credentials:

Site ID
Merchant ID
Secret Key
Gateway API Secret key
Test Mode = true/false

Success

You have connected Vendo H2H merchant account!

API examples:¶

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

This request will succeed if the constants are filled

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_usd_hpp",
      "commerce_account":"Hello World",
      "currency":"USD",
      "amount":10,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"252255af-234a-4d53-ac75-7022cea67bad"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"04dc2c05-7d28-49f9-8b47-95ad7d0ab43f",
      "service_fields":[
      ]
    }
  }
}

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

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_usd_hpp",
      "commerce_account":"Hello World",
      "currency":"USD",
      "amount":10,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"be6f7e37-c8dd-418a-a702-8322192cdea4",
        "name":"John Doe",
        "email":"[email protected]",
        "phone":"+4457395673965",
        "date_of_birth":"2000-02-08",
        "address":{
          "full_address":"Yerevan str",
          "country":"AM",
          "region":"ARM",
          "city":"Yerevan",
          "street":"Yerevan str",
          "post_code":"444444"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"ae23544c-196a-4157-9b9f-a6e053d1aa44",
      "service_fields":[
      ]
    }
  }
}

С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:

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

Question

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

Set up Account Provider account¶

Step 1: Create Provider account¶

To create an account send connection request at the vendoservices.com 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:

Merchant ID
Site ID
Secret Key
Gateway API Secret key
Test Mode = true/false

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

vendo__merchant_id → Merchant ID
vendo__site_id → Site ID
vendo__secret_key → Secret Key
vendo__gateway_api_secret_key → Gateway API Secret key
vendo__test_mode → Test Mode

Success

You have connected Vendo Provider account!

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

PAYMENT
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"bank_transfer_eur_hpp",
      "commerce_account":"hello_world",
      "currency":"EUR",
      "amount":10,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"1f066038-04be-446c-96dd-dfe2838d5536",
      "service_fields":[
      ]
    }
  }
}

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

PAYMENT
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"bank_transfer_eur_hpp",
      "commerce_account":"hello_world",
      "currency":"EUR",
      "amount":10,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"acf3c94d-da66-4ee9-bed4-be9fb29bf780",
        "first_name":"John",
        "last_name": "doe",
        "language": "EN",
        "email":"[email protected]",
        "phone":"+3807711122233",
        "address":{
          "country":"UK",
          "city":"London",
          "state": "London",
          "post_code":"123111",
          "full_address":"London City",
        },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"1f066038-04be-446c-96dd-dfe2838d5536",
      "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:

FULL_ADDRESS → customer [address] [full_address]
POST_CODE → customer[address][post_code]
FIRST_NAME → customer [first_name]
LAST_NAME → customer [last_name]
LANGUAGE → customer [language]
COUNTRY → customer [address] [country]
EMAIL → customer [address] [email]
PHONE → customer [address] [customer_phone]
REGION → customer [address] [region]
CITY → customer [address] [city]
IBAN → constants [iban]
IP → constants [ip]

Question

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