Providing the data required for personalization

PROVIDING THE DATA REQUIRED FOR PERSONALIZATION

To order a personalization, please submit your details following the technical description below.

The implementation of the service is using Representational State Transfer (REST) architecture (http://en.wikipedia.org/wiki/Representational_state_transfer)​,​ and JavaScript Object Notation (JSON) (http://json.org) data transfer protocol. The service is easy to use with different development platforms and languages ​​ with REST and JSON.

The results of requests are returned with standard HTTP response codes:

CARD DATA QUERY

The card data can be retrieved using an HTTP GET call from https://www.bercode.com/api/order/card. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page.

In case of a successful call, the BODY part of the response contains the data of the cards that can be ordered in JSON array, and in case of an error, the error message.

For example:

[{"card_id":207,"validation":2,"impersonation":0,"link":"https://www.bercode.com/images/uploads/card/5bec3f68506d8.png ","stock":480}]

SHIPPING, BILLING ADDRESSES QUERY

The shipping and billing address data can be retrieved using an HTTP GET call from https://www.bercode.com/api/order/address. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page.

In case of a successful call, the BODY part of the response contains the shipping and billing address data formatted in JSON array, and in case of an error, the error message.

For example:

[{"address_id":424, "type":1, "country_id":102, "state":"", "name":"Teszt Kft.", "zipcode":"1000", "settlement":"Budapest", "address":"Teszt u.", "number":"1.", "tax_number":"", "registration_number":"", "bank_account":""}, {"address_id":423, "type":2, "country_id":102, "state":"", "name":"Teszt Kft.", "zipcode":"1000", "settlement":"Budapest", "address":"Teszt u.", "number":"1.", "tax_number":"12345678-1-12", "registration_number":"", "bank_account":"11111111-22222222-33333333"}]

COUNTRY CODES QUERY

The country code data can be retrieved using an HTTP GET call from https://www.bercode.com/api/order/countries. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page.

In case of a successful call, the BODY part of the response contains the shipping and billing address data formatted in JSON array, and in case of an error, the error message.

For example:

[{"country_id":"3","name":"Afghanistan"},{"country_id":"16","name":"Aland Islands"},…]

QUERY FOR PARCEL PICK-UP LOCATIONS

You can also select GLS parcel points as a pick-up point for the delivery of the cards. The pick-up locations data can be retrieved using an HTTP GET call from https://www.bercode.com/api/order/dropoffpoints. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page.

In case of a successful call, the BODY part of the response contains the shipping and billing address data formatted in JSON array, and in case of an error, the error message.

For example:

[{"shop_id":"1011-CSOMAGPONT", "country_id":102, "zipcode":"1011", "settlement":"Budapest I.ker.", "address":"F\u0151 u. 35.", "name":"Csillagvir\u00e1g Gy\u00f3gyn\u00f6v\u00e9nybolt", "contact":"Dr.Jobb S\u00e1ndorn\u00e9", "phone":"06 1 791-3393", "iscodhandler":"1", "isparcellocker":"0", "lat":"47.5046007", "lng":"19.038533"},{"shop_id":"1023-NOGROUPGRP", " country_id ":102, "zipcode":"1023", "settlement":"Budapest", "address":"V\u00e9rhalom u. 18\/a", "name":"V\u00e9rhalom Delik\u00e1t", "contact":"Varga \u00c1kos", "phone":"20\/3773639", "iscodhandler":"1", "isparcellocker":"0", "lat":"47.5200475", "lng":"19.0295196"},…]

PROVIDING THE DATA REQUIRED FOR PERSONALIZATION

Data can be transferred using HTTP PUT calls to https://www.bercode.com/api/order. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page. A PUT can pass one order object at a time, formatted as a JSON array, as the body element of the PUT call. The MIME type of the PUT call should be application/json.

The card array data contains information about the cards. Multiple cards can be included in an order. A card array object shall carry the following content:

An object in the other array carries the following content:

{"name":"John Smith", "country_id":23, "state":"", "zipcode":"1234", "settlement":"Budapest", "address":"Nagy u.", "number":"3", [javascript protected email address] "phone":"+ 36 1 555 1234", "delivery":"1", "comment":"none", "card_id":"123", "card":[{"validity":"2019-07-20", "level":"5", "cardname":"John Smith"}]}

Enter image file:

{"name":"John Smith", "country_id":23, "state":"", "zipcode":"1234", "settlement":"Budapest", "address":"Nagy u.", "number":"3", [javascript protected email address] "phone":"+ 36 1 555 1234", "delivery":"1", "comment":"none", "card_id":"123", "card":[{"validity":"2019-07-20", "level":"5", "cardname":"John Smith", "other": [{"id": 1155, "content": "Other data"}, {"id": 1615, "content": "data:image/jpg;base64,/9j/4Q9URXhpZgAATU0AKgA..."}]}]}

In the case of a successful call, the BODY part of the response contains the order ID in a JSON object, and in the case of an error, the error message.

For example:

{"order_id":"PR18-00215"}

STATUS OF THE PERSONALIZATION AND RETRIEVAL OF THE COMPLETED BARCODES

The data can be retrieved using an HTTP GET call from https://www.bercode.com/api/order/[order_id]. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page.

In the [order_id] field, the order identifier returned when the previous naming information was entered must be entered.

In case of a successful call, the BODY part of the response contains the shipping and billing address data formatted in JSON array, and in case of an error, the error message.

An object in the codes array carries the following content:

For example:

{"status":3, "codes":[{"bercode":"411180 004323 200714"}]}

PERSONALIZATION FEE QUERY

The personalization fee data can be retrieved using an HTTP POST call from https://www.bercode.com/api/order. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page.

The card array data contains information about the cards. Multiple cards can be included in an order. A card array object shall carry the following content:

{"delivery":1, "card_id":123, "card":[{"validity":"2019-07-20", "level":5}]}

In the case of a successful call, the BODY part of the response will contain the name and currency of the call in JSON format, and in the case of an error, the error message.

For example:

 {"price":1450,"currency":"HUF"}

BALANCE QUERY

The balance data can be retrieved using an HTTP GET call from https://www.bercode.com/api/balance.php. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page.

In case of a successful call, the BODY part of the response contains the shipping and billing address data formatted in JSON array, and in case of an error, the error message.

For example:

{"balance":13350,"currency":"HUF"}

REQUEST A BALANCE UPLOAD

The balance upload data can be retrieved using an HTTP PUT call from https://www.bercode.com/api/balance.php. To log in, you must use HTTP Basic authentication with the Api Id and API Key you received on https://www.bercode.com in the Profile - Issuer Settings page. A PUT can pass one balance upload object at a time, formatted as a JSON array, as the body element of the PUT call. The MIME type of the PUT call should be application/json.

For example:

{"amount":"1000","address_id":"423"}

In the case of a successful call, the BODY part of the response contains the order ID in JSON format, and in the case of an error, the error message.

{ "order_id":"EF18-00226"}