Initialize the library using a network proxy

Before the library can be used, you must initialize it with the init_library function.

Implement the callback

Implement the initialization_CB and pass this as a parameter of the init_library call. For more information on how to do this, see Implement callbacks.

Code example

void initialization_CB(void *result, void *echo_struct){app_context_t * POS = (app_context_t *)echo_struct;
printf("library is initialized");
}

Parameters

Allocate request structure

Use init_library_allocate to allocate memory for an init_library_request structure. Populate the init_library_request by performing string duplication to fill heap-allocated strings.  The library automatically frees this memory.

Call the init_library function

Call the init_library function with the provided parameters to initialize the library.

Parameters

Get the function call result

ADYLibraryResult is used to store the result of the function call, the immediate response to the call. This is an enum that indicates if the system received the request. Should be ADYEN_OK, if this is not the case, something has gone wrong. In this case, check the input to the call and if it cannot be resolved, log the result and contact Support Team

Handle the callback

The POS needs to wait for the initialization callback before continuing with other functions, like boarding the POS systems and PED devices, and performing transactions.

Parameters

Code example

typedef struct {
  char *user_data;
} app_context_t;

// result is always null for initialization callback
void initialization_CB(void *result, void *echo_struct) {
app_context_t * POS = (app_context_t *)echo_struct;
printf("library is initialized");
}

main()
{
  app_context_t POS;
    init_library_request *initReq = init_library_allocate();
    initReq->pos_name = strdup("Adyen");
    initReq->app_name = strdup("Adyen");
//Define the proxy here
//Add a username to the end and a port number
//Supported protocols are: https, socks4a and socks5h
    initReq->backend_use_proxy = "socks5h://my.awesome.proxy.url:3208";
    .
    .
    .
    ADYLibraryResult result = init_library(initReq, initialization_CB, &POS);
}

For more information on formatting a proxy URL, including specific ports and user credentials, see the CURLOPT_PROXY documentation.