Unity Finance¶

Seamless payments, boundless possibilities Connecting currencies, empowering transactions worldwide

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

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

unityfinance__api_user → API user
unityfinance__api_key → API key
unityfinance__checkout_id → Checkout ID
unityfinance__secret_key → Secret Key
unityfinance__payment_method → Payment method
unityfinance__currency → choose currency (You can set these parameters according to available currencies and features for your Unity Finance 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 Unity Finance Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Connect

Enter credentials:

API user
API key
Checkout ID
Secret Key
Payment method
Currency

Success

You have connected Unity Finance H2H merchant account!

API examples:¶

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

SALE
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "commerce_account":"hello_world",
      "currency":"EUR",
      "amount":10,
      "reference_id":"d5999bf5-e550-4567-b4b2-8bf7337d7ec1",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"c17e05ef-d10e-478a-8e62-a3817a80c8a4",
        "name":"John Wick",
        "email":"[email protected]",
        "phone":"+380680786663"
      },
      "callback_url":"https:\/\/24e0-3-65-180-235.ngrok-free.app",
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

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

SALE
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "commerce_account":"hello_world",
      "currency":"EUR",
      "amount":10,
      "reference_id":"eed3f1bb-ea16-4e2d-9e4b-91e9fbbc5502",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"0f0d27c5-104e-4275-b6c0-e6bd64bc2cec",
        "name":"Jhon Wick",
        "email":"[email protected]",
        "phone":"+380680786663",
        "address":{
          "full_address":"Address",
          "country":"UA",
          "region":"State",
          "city":"City",
          "post_code":"X1J 5AX"
        }
      },
      "callback_url":"https:\/\/24e0-3-65-180-235.ngrok-free.app",
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

Provider Options¶

Provider_Options

provider_url_blacklist → verification and block the blacklisted action URLs on redirect;
ignore_callback → for cascading to work correctly, we exclude the possibility of finalizing payments using asynchronous callbacks, ignore the callback, do not change the status of the transaction on it in any way and rely only on the status request for finalization (Reconciliation)

Question

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