Payabl.

Website: payabl.com

Set up Account Provider account

Step 1: Create Provider account

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

• payabl__merchant_id → Merchant ID
• payabl__secret_key → Secret Key
• payabl__api_url → API URL

Connect Provider Account

Step 1. Connect Provider account at the Corefy Dashboard

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

Enter credentials:

• Merchant ID
• Secret Key
• API URL

You have connected Payabl. Provider account!

Set up Account H2H merchant account

Step 1: Create Merchant Account

To create an account send connection request at the payabl.com/contact 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
• Secret Key

Connect H2H Merchant Account

Step 1. Connect H2H account at the Corefy Dashboard

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

Enter credentials:

• Merchant ID
• Secret Key
• API URL → API URL, e.g. sandbox.payabl.com/pay/payment
• Save Instant Token → true/false
• Acquirer BIN → required if "Use MPI" are enabled, Acquiring institution identification code (Typically his is 6-digit BIN assigned to the acquirer by Visa or Mastercard)
• Acquirer Merchant ID → required if "Use MPI" are enabled, Merchant ID account or Card Acceptor ID provided by the acquiring bank
• Use MPI → true/false, if enabled, the system will use MPI (3D Secure) for card payments. If disabled, the system will use provider's 3D Secure solution
• Default address params → choose default customer params
• Currency → choose currency

You have connected Payabl. H2H merchant account!

Default address parameters

The Default address params setting defines which customer address values will be used when the corresponding address details are not provided in the payment request.

The following presets are available:

• London — default address in London, United Kingdom
• USA — default address in the United States
• EU — default address in Berlin, Germany
• Iraq — default address in Baghdad, Iraq

The selected preset provides fallback values for the customer's street, postal code, city, region, and country.

The following connection Constants can also be configured:

• Street — customer's street address
• Post code — customer's postal or ZIP code
• City — customer's city
• Region — customer's state, province, or region
• Country — customer's country

Address values are selected in the following order of priority:

1. Customer data provided in the payment request
2. Connection constants
3. Values from the selected Default address params preset

Therefore, when an address constant is configured and the corresponding customer value is missing, the configured constant will be sent instead of the default value.

If a default address preset is not available for the required country, select any existing preset and configure all address constants listed above. When all five constants are configured, the selected preset's address values will not be used unless a corresponding constant is missing.

API examples:

Minimum data set to create a payment invoices for applepay_eur_hpp service

PAYMENT

POST /api/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "applepay_eur_hpp",
      "currency": "EUR",
      "amount": 1,
      "flow": "charge",
      "customer": {
        "reference_id": "199be985-c243-478a-86a8-4b8c902e5bb6",
        "email": "test@test.com",
        "name": "John Doe",
      },
      "test_mode": false,
      "reference_id": "6be05631-8710-4b14-a369-1928a2b70eda",
      "service_fields": []
    }

Maximum data set to create a payment invoices for payment_card_eur_hpp service

POST /api/payment-invoices HTTP/1.1

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "882f2326-0451-473a-9c43-3c6b1b8997e9",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 1,
      "flow": "charge",
      "test_mode": false,
      "customer": {
        "reference_id": "4755",
        "name": "John Smith",
        "email": "test+12223334455@test.com",
        "date_of_birth": "2000-12-31",
        "address": {
          "full_address": "1st Avenue North",
          "country": "US",
          "city": "New York",
          "region": "Test",
          "street": "Test",
          "post_code": "12345"
        }
      }
    }
  }
}

Provider Options

• 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)
• set_fail_without_reconciliation
  • if on, and current payment status is in fail group, the status of the reconciliation will be set to fail without request to provider

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