Exactly¶

Website: exactly.com

Login: dash.exactly.com

Follow the guidance for setting up a connection with Exactly payment service provider.

Set Up Account¶

Step 1: Contact Exactly support manager¶

Send a request on the exactly.com. Submit the required documents to verify your account and gain access.

Create a shop and provide to Exactly:

• the name of your store (Shop name) and the actual shop's URL
• the list of IP addresses, from which you perform requests to the Exactly API (ensure to specify IP addresses from the Corefy list
• the Success and Failed Return URLs where the customer is returned depending on transactions' results
• the Callback URL

If you plan using dynamic URIs, you must contact Exactly support and specify the domain names of the hosts different from the default ones.

Step 2: Get credentials¶

• api_key → api_token
• After the shop's setup, you obtain the secret token for the API calls (API Key)

Connect Provider Account¶

Step 1. Connect account at the Corefy Dashboard¶

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

Enter credentials:

• API Key
• Enter the API key (api_token).

Connect H2H Merchant Account¶

Step 1. Create Merchant Account¶

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

Step 2: Get required credentials¶

Credentials that have to be issued:

• api_key → API Key
  • After the shop's setup, you obtain the secret token for the API calls (API Key)
• currency → choose currency (You can set these parameters according to available currencies and features for your Exactly 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 Exactly Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Enter credentials:

• API Key
  • Enter the API key (api_token)

API examples:¶

Minimum data set to create a payment invoices for payment_card¶

PAYMENT

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":12,
      "reference_id":"7de367da-96ff-47d4-8ba1-c48cd3a0457e",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"b0a39d20-9252-456a-9415-6eb8c865a947",
        "email":"[email protected]"
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

Minimum data set to create a transaction¶

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":45,
      "reference_id":"97040243-5a80-4fa5-9e7e-baba81b16117",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"ece8c6cc-c2de-4b2e-a645-6643545a2f77",
        "email":"[email protected]"
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}