Payok¶

Online Payment Solutions

Set up Account Provider account¶

Step 1: Create Provider account¶

To create an account send connection request at the www.payok.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
Public key
Private key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

payok_merchant_id → Merchant ID
payok_public_key → Public key
payok_private_key → Private key
Currency → choose currency (You can set these parameters according to available currencies and features for your Payok wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)
Test Mode → true/false

Success

You have connected Payok Provider account!

API examples:¶

Minimal data set to create a payment invoices for ovo_idr_hpp service¶

SALE
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"ovo_idr_hpp",
      "commerce_account":"Hello_world",
      "currency":"IDR",
      "amount":10000,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"acf3c94d-da66-4ee9-bed4-be9fb29bf780",
        "name":"John doe",
        "email":"[email protected]",
        "phone":"+3807711122233",
        }
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"9ece2e52-3a87-4f87-bc26-467b82d8ce00",
      "service_fields":[
      ]
    }
  }
}

Maximal data set to create a payment invoices for ovo_idr_hpp service¶

SALE
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"ovo_idr_hpp",
      "commerce_account":"Hello_world",
      "currency":"IDR",
      "amount":10000,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"acf3c94d-da66-4ee9-bed4-be9fb29bf780",
        "name":"John doe",
        "personal_id": "12345",
        "phone":"+3807711122233",
        "email":"[email protected]",
        "ip": "192.168.4.2",
        "address":{
          "country":"UK",
          "city":"London",
          "post_code":"123111",
          "full_address":"London City",
        }
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"9ece2e52-3a87-4f87-bc26-467b82d8ce00",
      "service_fields":[
      ]
    }
  }
}

Constants¶

Сonstants

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:

FULL_NAME → customer [address] [full_name]
EMAIL → customer [address] [email]
PHONE → customer [address] [phone]
DEVICE_ID → customer [device_id]

Provider Options¶

Provider_Options

Use english language - sends language parameter to provider

Question

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