Symoco¶

Set up Account¶

Step 1: Create merchant account¶

To create an account send connection request at the symoco.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_site_id
refresh_access_token

Connect H2H Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

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

Connect

Enter credentials:

merchant_site_id → Merchant Site ID
refresh_access_token → Refresh Access Token
currency → choose currency (You can set these parameters according to available currencies and features for your Symoco wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Success

You have connected Symoco H2H merchant account!

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

merchant_site_id → Merchant Site ID
refresh_access_token → Refresh Access Token

Success

You have connected Symoco Provider account!

API examples:¶

Maximum data set to create a payment-invoice:¶

POST /api/commerce/payment-invoices HTTP/1.0

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_uzs_hpp",
      "commerce_account": "Hello World",
      "currency": "UZS",
      "amount": 12,
      "reference_id": "7b6d677f-201e-41ca-bdf9-b0a760765774",
      "flow": "charge",
      "customer": {
        "phone": "18001002030",
        "email": "[email protected]",
        "name": "John Doe",
        "country": "USA",
        "date_of_birth": "1960-02-25",
        "adress": {
          "full_address": "Av. da Liberdade, 87",
          "city": "Sao Paulo",
          "region": "SP",
          "postalCode": "05907",
          "street": "6587 Roller Derby Lane, Toronto, ON M1R-0E9, Canada"
        }
      },
      "test_mode": false,
      "options": {
        "allow_partially": false
      }
    }
  }
}

Minimum data set to create a payment-invoice:¶

POST /api/commerce/payment-invoices HTTP/1.0

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_uzs_hpp",
      "commerce_account": "Hello World",
      "currency": "UZS",
      "amount": 12,
      "reference_id": "7b6d677f-201e-41ca-bdf9-b0a760765774",
      "flow": "charge",
      "test_mode": false,
      "options": {
        "allow_partially": false
      }
    }
  }
}

Data set to create a payout:¶

POST /api/commerce/payout-invoices HTTP/1.0

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uzs",
      "commerce_account": "Hello World",
      "currency": "UZS",
      "amount": 123,
      "reference_id": "9c10518e-29c0-4dac-bf4e-7fb9197542e8",
      "context": {
        "card": {
          "card_holder": "John Wick",
          "exp_year": "30",
          "exp_month": "01"
        },
        "customer": {
          "reference_id": "c7acae38-843e-422a-83aa-4a4137d44ecb",
          "name": "John Doe",
          "email": "[email protected]",
          "phone": "18001002031",
          "address": {
            "full_address": "Av. da Liberdade, 87",
            "country": "BT",
            "region": "1234",
            "city": "Sao Paulo",
            "street": "Av. da Liberdade, 87",
            "post_code": "123"
          }
        }
      },
      "test_mode": false,
      "fields": {
        "card_number": "411111******1111"
      },
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

Additional information¶

Constants¶

Constants

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] [fullAddress]
REGION → customer [address] [region]
COUNTRY_CODE → customer [address] [country]
CITY → customer [address] [city]
POST_CODE → customer [address] [postCode]
EMAIL → customer [email]
NAME→ customer [name]
PHONE → customer [phone]
DATE_OF_BIRTH → customer [date_of_birth]
REFERENCE_ID → customer [reference_id]

Still looking for help connecting your Symoco account?

Please contact our support team!