{"title":"Register the PED with the Adyen payments platform","category":"default","creationDate":1776961627,"content":"

Before using the connected PEDs to process transactions on the plataforma de pagamentos da Adyen, you must authenticate and authorize them with the\u00a0plataforma de pagamentos da Adyen (at least once).\u00a0Authenticate and authorize the PED by making a register_device<\/code> call to the library with input parameters. The library returns a callback. Process this after the system processes the PED registration call.\u00a0<\/p>\n

After you authenticate and authorize each PED, they are registered in your Customer Area<\/a><\/p>\n

\n

The call and the callback are asynchronous to prevent the call from blocking the calling thread.<\/p>\n<\/div><\/div>\n

Register the PED after you authenticate and authorize the POS<\/a>. If the POS is not authenticated and authorized, the call fails.<\/p>\n

Implement the callback<\/h2>\n

Implement the\u00a0register_ped_CB<\/code>\u00a0and pass this as a parameter of the register_device<\/code> call. For more information on how to do this, see\u00a0Implement callbacks<\/a>.<\/p>\n

Code example<\/h3>\n

The callback function declaration is:\u00a0<\/p>\n

void register_ped_CB(register_device_response * result, void * echo_struct)<\/code><\/pre>\n
Allocate request structure<\/h2>\n
Use register_dev_allocate<\/code> to allocate a\u00a0register_device_request<\/a> structure. Populate the request\u00a0by performing string duplication to fill heap-allocated strings.\u00a0\u00a0The library automatically frees this memory..<\/p>\n
Call the register_device Function<\/h2>\n
Call the register_device<\/code> function to\u00a0authenticate and authorize the PED by making this\u00a0call to the library with input parameters. The library returns a callback. Process this after the system processes the PED registration call.\u00a0<\/p>\n
Parameters<\/h3>\n<\/colgroup>
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
\n
register_dev_req<\/code><\/p>\n<\/td>
\n
register_device_request<\/a><\/p>\n<\/td>
\n
\"-white_check_mark-\"<\/p>\n<\/td>
\n
Pointer to the\u00a0register_device_request<\/code>\u00a0struct, this struct contains all the input parameters for this call. For a list of parameters, see\u00a0register_device_request<\/a>.
\n
register_ped_CB<\/code><\/p>\n<\/td>
\n
Function<\/p>\n<\/td>
\n
\"-white_check_mark-\"<\/p>\n<\/td>
\n
Pointer to the callback function the system returns to the POS with the results of the register_device<\/code> call.<\/p>\n<\/td><\/tr>
\n
echo_struct<\/code><\/p>\n<\/td>
\n
Struct:\u00a0echo_struct<\/a><\/p>\n<\/td>
\n
\"-white_check_mark-\"<\/p>\n<\/td>
\n
Pointer to a POS defined struct that is echoed back in the callback. Use echo_struct to share a POS data struct between the call to the library and the callback from the library in response to the call.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n
\n
You can register more than one PED on the library with the register_device function.<\/p>\n<\/div><\/div>\n
Code example<\/h3>\n
The declaration of the call to register the PED is as follows:<\/p>\n
ADYLibraryResult register_device_result = register_device(register_device_request_ptr, register_ped_CB, &state);<\/code><\/pre>\n
Handle the callback<\/h2>\n
The POS needs to wait for the register_ped_cb<\/code> to happen, before it can continue with other functions.<\/p>\n
Parameters<\/h3>\n
The callback passes the following parameters:<\/p>\n<\/colgroup>
Value<\/th>Description<\/th><\/tr><\/thead>
\n
ped_device_info<\/code><\/p>\n<\/td>
\n
A pointer to a ped_device_info<\/code>\u00a0struct that defines the status and details of the PED. For a list of parameters, see\u00a0ped_device_info<\/a>.These data elements are recorded in the\u00a0Customer Area<\/a>.The\u00a0terminal_serial_number<\/code>, terminal_type<\/code>, terminal_brand<\/code>, terminal_api_version<\/code>, terminal_os_version<\/code>,\u00a0and\u00a0terminal_hardware_version<\/code>\u00a0data elements are used to define the exact state of the PED. Use these elements to investigate issues.<\/p>\n<\/td><\/tr>
\n
echo_struct<\/code><\/p>\n<\/td>
\n
A pointer to a User-defined struct that can be set by the POS on the device_callbacks<\/code> struct and which is being echoed back here.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n
Other Register device callback functions<\/h2>\n
To allow the library to return callbacks specified by the POS. they need to be provided to the library. The callback functions are registered during the register device stage, where the callbacks handlers are specified in the callbacks structure of the register_device_request<\/code>.<\/p>\n
The following callback functions must be specified:<\/p>\n