Katarun¶

Tailored to you Providing your business with a robust financial solution, that promotes growth, tailored to your business needs is our core objective.

Website: katarun.com

Set up Account Provider account¶

Step 1: Create Provider account¶

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

katarun__brand_id → Brand ID
katarun__api_key → API key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

Brand ID
API key
Currency

Success

You have connected Katarun Provider account!

API examples:¶

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

PAYMENT
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payshop_eur_hpp",
      "commerce_account":"hello_world",
      "currency":"EUR",
      "amount":0.01,
      "reference_id":"0095220c-92c4-43a6-85ed-8742c2c3c312",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"165f54d0-d029-45db-bea5-55a66bf3411c",
        "email":"[email protected]"
      },
      "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 mb_way_eur_invoice service¶

PAYMENT
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"mb_way_eur_invoice",
      "commerce_account":"hello_world",
      "currency":"EUR",
      "amount":1,
      "reference_id":"04dd60d5-816e-4e2e-ad00-f6d2ca180f1f",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"30f4ad5c-df9c-4be0-8520-3411ef568432",
        "email":"[email protected]",
        "phone":"+351915032559"
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

Provider Options¶

Provider_Options

finalize_by_protocol:
- if finalize by protocol option is true then using STRICT_PAYMENT_STATUS_MAP;
- if finalize by protocol option is false then using SOFT_PAYMENT_STATUS_MAP;

Question

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