Software development kit (SDK)

At the moment there is only one SDK available:

The corresponding examples you can find in the Github Repository as well:
github.com/uConekt/uconekt-php/tree/master/examples

🚧

Troubles integrating our API in your programming language?

No problem. Please contact our support team at [email protected]

Request

The payload data has to be RFC 3986 (http://www.ietf.org/rfc/rfc3986.txt) url encoded and spaces will be percent encoded "%20".

The basic URL to our API is: https://api.uconekt-pay.com/v1.0/:object/:id?instance=:instance

Parameter

Value

object

AuthToken | Invoice | Page | Subscription

id

Only used for request types GET, PUT and DELETE where only one entity gets modified.

instance

The Uconektpay instance name.
If you access your Uconektpay payment page with example.uconekt-pay.com, the name would be example

Authentication - API signature

📘

Is this important for you?

This part of the documentation is only important if you are not using an SDK.

The API signature is a HMAC (RFC 2104).

For security reasons we want you to pass an API signature calculated with the API Secret of your instance.
The parameter name of this API signature should be ApiSignature. You can calculate the signature using all params except the param instance.

  • Build query string (e.g. model=Page&id=17)
  • Calculate binary hmac hash using your instance's API Secret as key
  • Encode it with base64
base64_encode(hash_hmac('sha256', http_build_query($params, null, '&'), $apiSecret, true));

🚧

Encoding of HTTP-Query String

The query string has to be RFC 1738 encoded, that means you have to replace spaces by "+".
You can probably use: http://linux.die.net/man/1/urlencode