Skip to content

Logo

Apay

Set up Account

Step 1: Get required credentials

Credentials that have to be issued:

  • Api key

Connect Provider Account

Step 1. Connect Provider account at the Corefy Dashboard

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

Connect

Enter credentials:

  • Merchant ID → unique Merchant identifier generated by merchant
  • API URL → optional? if you need to specify base url for payments
  • Callback Secret Key → secret key for callback generated by merchant
  • Test Mode → true/false
  • API key → Secret api key for authorization

Success

You have connected Apay Provider account!

API examples

Data set to create a Payment:

POST /api/commerce/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "oprnbanking_eur_hpp",
      "commerce_account": "Hello_World",
      "currency": "EUR",
      "amount": 1200,
      "flow": "charge",
      "customer": {
        "reference_id": "cff9b603-8c74-454f-9b66-73f349f12aec",
        "name":"John Doe",
        "email":"test@gmail.com",
        "metadata": {
          "ip": "192.168.72.1"
        }
      },
      "return_url": "https://test.com/default",
      "return_urls": {
        "fail": "https://test.com/fail",
        "success": "https://test.com/success"
      },
      "test_mode": false,
      "options": {
        "seconds_to_expire": '600',
      },
      "reference_id": "bb756e15-428b-47f8-81dd-90014d5eb607"
    }
  }
}

Options

Options

Here is a list of Options with their corresponding parameters:

  • seconds_to_expire → Seconds to expire transaction status. If empty - default value "360" will be passed
  • api_type → possible values: V1 or V2, indicates to which api type endpoint will be used

Question

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