Alliancepay¶

Website: alliancepay.io

Set up Account¶

Step 1: Create merchant account¶

To create an account send connection request at the alliancepay.io 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
• Service code
• Payment key
• Private key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Enter credentials:

• merchant_id → Merchant ID
• payment_key → Payment Key (Upload text file with payment key)
• private_key → Private Key (Upload text file with private key)
• service_code → Service Code

You have connected Alliancepay Provider account!

Connect H2H Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

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

Enter credentials:

• Merchant ID → Merchant ID
• Payment Key → Payment Key (Upload text file with payment key)
• Private Key → Private Key (Upload text file with private key)
• Service Code → Service Code
• API type → Select API type according for your Alliancepay account

Choose Currency and Features. You can set these parameters according to available currencies and features for your Alliancepay account, but it's necessary to check details of the connection with your Corefy account manager.

!!! success You have connected Alliancepay H2H merchant account!!!

API examples for payouts:¶

Maximum data set to create a payout invoices¶

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

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "commerce_account": "Hello world",
      "currency": "UAH",
      "amount": 10,
      "reference_id": "fc004385-386d-469f-a900-586effe2fb6f",
      "test_mode": false,
      "fields": {
        "card_number": "537541******0175"
      },
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

Minimum data set to create a transaction¶

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

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "commerce_account": "HELLO WORLD",
      "currency": "UAH",
      "amount": 10.13,
      "reference_id": "eac942ea-71ca-4631-989f-2f80432522c9",
      "customer": {
        "reference_id": "33cc9165-6ab2-4cee-8d9a-10f05cddbb5a",
        "name": "John Doe",
        "address": {
          "country": "UA",
          "city": "Lviv",
          "street": "Lviv"
        }
      },
      "test_mode": false,
      "fields": {
        "card_number": "537541******0175"
      },
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

API examples for payments:¶

Maximum and minimum data set to create a payments invoices¶

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

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_uah_hpp",
      "commerce_account": "hello world",
      "currency": "UAH",
      "amount": 10.04,
      "flow": "charge",
      "test_mode": false,
      "options": {
        "allow_partially": false
      },
      "reference_id": "c2dd9b58-38a2-44a4-89ed-50f09f60e0ec"
    }
  }
}

Additional information¶

Constants for Provider account¶

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:

• STREET → customer [address] [street]
• COUNTRY → customer [address] [country]
• CITY → customer [address] [city]
• NAME→ customer [name]

Please contact our support team!