Customer information - permitted currencies

GET

/customer

Customer

Meaning and purpose

The GET /customer method ensures that the application retrieves a list of bank accounts and related information registered for the given customer (sender). This overview is especially useful if:

You are sending shipments abroad and need to know in which currency cash on delivery (COD) can be accepted, or

You want to have SWIFT/BIC codes and bank details available for a specific country.
Thanks to the response from this method, it is possible to determine which accounts the sender has registered with PPL, allowing you to dynamically decide in which currency (and via which account) payments will be settled, especially in the case of COD.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/customer' \
--header 'Accept-Language;' \
--header 'X-Correlation-ID;' \
--header 'X-LogLevel;'

Response Example

200 - Example 1

{
  "accounts": [
    {
      "bankCode": "0100",
      "country": "CZ",
      "currency": "CZK",
      "swift": "KOMBCZPP"
    }
  ]
}

Request

Header Params

Accept-Language

string

optional

Language specification, default language: cs-CZ

X-Correlation-ID

string

optional

Correlation Id of request

X-LogLevel

enum<string>

optional

The forced log level

Allowed values:

TraceDebugInformationWarningErrorCritical

Responses

🟢200OK

application/json

Success

Headers

X-Correlation-ID

string

optional

Correlation Id of request otherwise id of response

Body

accounts

array [object {4}] | null

optional

Accounts

bankCode

string | null

optional

The bank code that, together with the account number (which is in another field in the API), identifies the target account in that country.

<= 4 characters

Example:

0100

country

string

required

Country code or designation of the country for which the account is intended.
Allows you to select the correct account and currency when sending to a specific country.

>= 2 characters

Example:

currency

string

required

Abbreviation of the currency in which this account is maintained.
It helps to distinguish whether cash on delivery can be settled in a given currency.

>= 3 characters

Example:

CZK

swift

string | null

optional

Bank identification code used for international payments.
It is necessary for foreign payments, especially when transferring cash on delivery in another currency.

<= 50 characters

Example:

KOMBCZPP

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

🔴503Service Unavailable

Modified at 2025-02-07 13:00:52

Types of personal documents

Customer addresess

Customer information - permitted currencies

Meaning and purpose#

Request

Responses

Meaning and purpose