CreateCard Scenarios

Private Base Cards

CreateCard Base Private [2.6]

Base Private Card with New Client and New Agreement

Parameters:

"privateClient": {

// mandatory block for New Base Card

"id": "",

// Can be absent

(in order to create new Client)

// Can be filled with own value

(in order to create new Client with own id)

"name": "",

"surname": "",

"mobilePhone": "",

// mandatory parameters

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// Can be absent

(in order to create new "card.cardAccount")

// Can be filled with own value

(in order to create new "card.cardAccount" with own id)

"currencies": [""],

// mandatory parameter

"holder": { },

// parameters will be ignored

(holder is a Private Client)

"deliveryAddress": { },

// mandatory block for Plastic Cards

(will be used in Client Agreement)

"supplementary": "false",

// FALSE is mandatory for BASE card

Example:

    "privateClient": {

        "name": "{{name}}",

        "surname": "{{surname}}",

        "mobilePhone": "{{mobilePhone}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "currencies": ["{{currencies}}"],

        "deliveryAddress": {

            "country": "{{country}}",

            "city": "{{city}}",

            "street": "{{street}}",

        },

        "supplementary": "false",

    },

Validations:

- CreateCard will be rejected if provided "privateClient.id" already exists;

- CreateCard will be rejected if "privateClient.name" OR "privateClient.surname" is not provided;


CreateCard Base Private [2.6]

Attached Private Card with New Agreement

Parameters:

"privateClient": {

// mandatory block for New Base Card

"id": "",

// mandatory parameter, existing ID

(in order to use existing Client data)

Other parameters will be ignored

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// Can be absent

(in order to create new "card.cardAccount")

// Can be filled with own value

(in order to create new "card.cardAccount" with own id)

"currencies": [""],

// mandatory parameter

"holder": { },

// block should be absent

(holder is a Private Client)

"deliveryAddress": { },

// mandatory block for Plastic Cards

(will be used in Client Agreement)

"supplementary": "false",

// FALSE is mandatory for BASE card

Example:

    "privateClient": {

        "id": "{{id}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "currencies": ["{{currencies}}"],

        "deliveryAddress": {

            "country": "{{country}}",

            "city": "{{city}}",

            "street": "{{street}}",

        },

        "supplementary": "false",

    },

Validations:

- CreateCard will be rejected if provided "card.productCode" not registered;

- CreateCard will be rejected if provided "card.currencies" doesn't match with registered "card.productCode";

- CreateCard will be rejected if provided "privateClient.id" not exists;


CreateCard Base Private [2.6]

Attached Private Card with Existing Agreement

Parameters:

"privateClient": {

// mandatory block for New Base Card

"id": "",

// mandatory parameter, existing ID

(in order to use existing Client data)

Other parameters will be ignored

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// mandatory parameter, existing Account

(in order to use existing "card.cardAccount")

"currencies": [""],

// mandatory parameter

"holder": { },

// block should be absent

(holder is a Private Client)

"deliveryAddress": { },

// parameters will be ignored

"supplementary": "false",

// FALSE is mandatory for BASE card

Example:

    "privateClient": {

        "id": "{{id}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "cardAccount": "{{cardAccount}}"

        "currencies": ["{{currencies}}"],

        "supplementary": "false",

    },

Validations:

- CreateCard will be rejected if provided "privateClient.id" not exists;

- CreateCard will be rejected if provided "card.productCode" does not match the details of the existing agreement;

- CreateCard will be rejected if provided "card.currencies" does not match the details of the existing "card.cardAccount";


Private Supplementary Cards

CreateCard Supplementary Private [2.6]

Supplementary Private Card with new Client

Parameters:

"privateClient": {

// mandatory block for New Base Card

"id": "",

// mandatory parameter, existing ID

(in order to use existing Client data)

Other parameters will be ignored

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// mandatory parameter, existing Account

(in order to use existing "card.cardAccount")

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block should contain Client data

(holder as Supplementary Card owner)

"id": "",

// Can be absent

(in order to create new Client)

// Can be filled with own value

(in order to create new Client with own id)

"name": "",

"surname": "",

"mobilePhone": "",

// mandatory parameters

},

"deliveryAddress": { },

// parameters will be ignored

"supplementary": "true",

// True is mandatory for Supplementary card

Example:

    "privateClient": {

        "id": "{{id}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "cardAccount": "{{cardAccount}}"

        "currencies": ["{{currencies}}"],

        "holder": {

            "name": "{{name}}",

                "surname": "{{surname}}",

                "mobilePhone": "{{mobilePhone}}",

        },

        "supplementary": "true",

    },

Validations:

- CreateCard will be rejected If provided "card.productCode" does not match the product of the found agreement

- CreateCard will be rejected if provided "card.currencies" does not match the details of the existing card account

- CreateCard will be rejected if provided "privateClient.id" or "card.productCode" could not be found

- CreateCard will be rejected if provided "card.cardAccount" do not match requested "privateClient.id"


CreateCard Supplementary Private [2.6]

Supplementary Private Card with existing Client

Parameters:

"privateClient": {

// mandatory block for New Base Card

"id": "",

// mandatory parameter, existing ID

(in order to use existing Client data)

("privateClient.id" should be used from initial client, base Card owner)

Other parameters will be ignored

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// mandatory parameter, existing Account

(in order to use existing "card.cardAccount")

("card.cardAccount" should be used from initial client, base Card owner)

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block should contain Client data

"id": "",

// mandatory parameter, existing 2nd Client.

(in order to use existing Client data)

("card.holder.id" should be used from another client, planned to be used as Supplementary Card owner)

},

"deliveryAddress": { },

// parameters will be ignored

"supplementary": "true",

// True is mandatory for Supplementary card

Example:

    "privateClient": {

        "id": "{{id}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "cardAccount": "{{cardAccount}}"

        "currencies": ["{{currencies}}"],

        "holder": {

            "id": "{{id}}",

        },

        "supplementary": "true",

    },

Validations:

- CreateCard will be rejected If provided "card.productCode" does not match the product of the found agreement

- CreateCard will be rejected if provided "card.currencies" does not match the details of the existing "card.cardAccount"

- CreateCard will be rejected if provided "privateClient.id" or "card.cardAccount" could not be found

- CreateCard will be rejected if provided "card.cardAccount" do not match requested "privateClient.id"


Business Base Cards

CreateCard Base Business [2.6]

Base Business Card with New Client and New Agreement

Parameters:

"businessClient": {

// mandatory block for Business Card

(Company data)

"registrationNumber": ""

// mandatory parameter

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// Can be absent

(in order to create new "card.cardAccount")

// Can be filled with own value

(in order to create new "card.cardAccount" with own id)

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block should contain Client data

(Business Cardholder data)

"id": "",

// Can be absent

(in order to create new Client)

// Can be filled with own value

(in order to create new Client with own id)

"name": "",

"surname": "",

"mobilePhone": "",

// mandatory parameters

},

"deliveryAddress": { },

// mandatory block for Plastic Cards

(will be used in Client Agreement)

"supplementary": "false",

// FALSE is mandatory for BASE card

Example:

    "businessClient": {

        "registrationNumber": "{{registrationNumber}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "currencies": ["{{currencies}}"],

        "holder": {

            "name": "{{name}}",

                "surname": "{{surname}}",

                "mobilePhone": "{{mobilePhone}}",

        },

        "deliveryAddress": {

            "country": "{{country}}",

            "city": "{{city}}",

            "street": "{{street}}",

        },

        "supplementary": "false",

    },


CreateCard Base Business [2.6]

Additional Business Card with New Client and New Agreement

Parameters:

"businessClient": {

// mandatory block for Business Card

"registrationNumber": ""

// mandatory parameter, existing RegNum

(in order to create Business Card within the same Company)

// other parameters should match if used

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// Can be absent

(in order to create new "card.cardAccount")

// Can be filled with own value

(in order to create new "card.cardAccount" with own id)

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block should contain Client data

(Business Cardholder data)

"id": "",

// Can be absent

(in order to create new Client)

// Can be filled with own value

(in order to create new Client with own id)

"name": "",

"surname": "",

"mobilePhone": "",

// mandatory parameters

},

"deliveryAddress": { },

// mandatory block for Plastic Cards

(will be used in Client Agreement)

"supplementary": "false",

// FALSE is mandatory for BASE card

Example:

    "businessClient": {

        "registrationNumber": "{{registrationNumber}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "currencies": ["{{currencies}}"],

        "holder": {

            "name": "{{name}}",

                "surname": "{{surname}}",

                "mobilePhone": "{{mobilePhone}}",

        },

        "deliveryAddress": {

            "country": "{{country}}",

            "city": "{{city}}",

            "street": "{{street}}",

        },

        "supplementary": "false",

    },

Validations:

- CreateCard will be rejected if provided "businessClient" details do not match existing business client


CreateCard Base Business [2.6]

Attached Business Card with New Agreement (existing business client and existing cardholder)

Parameters:

"businessClient": {

// mandatory block for Business Card

"registrationNumber": ""

// mandatory parameter, existing RegNum

(in order to create Business Card within the same Company)

// Other parameters will be ignored

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// Can be absent

(in order to create new "card.cardAccount")

// Can be filled with own value

(in order to create new "card.cardAccount" with own id)

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block should contain Client data

"id": "",

// mandatory parameter, existing Client ID

(in order to use existing Business Cardholder data)

// Other parameters will be ignored

},

"deliveryAddress": { },

// mandatory block for Plastic Cards

(will be used in Client Agreement)

"supplementary": "false",

// FALSE is mandatory for BASE card

Example:

    "businessClient": {

        "registrationNumber": "{{registrationNumber}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "currencies": ["{{currencies}}"],

        "holder": {

            "id": "{{id}}",

        },

        "deliveryAddress": {

            "country": "{{country}}",

            "city": "{{city}}",

            "street": "{{street}}",

        },

        "supplementary": "false",

    },

Validations:

- CreateCard will be rejected if provided "businessClient.registrationNumber" could not be found

- CreateCard will be rejected if provided "card.holder.id" could not be found

- CreateCard will be rejected if provided "businessclient.registrationnumber" does not match the registration number of original Business Client


CreateCard Base Business [2.6]

Attached Business Card with existing Agreement (existing business client and existing cardholder)

Parameters:

"businessClient": {

// mandatory block for Business Card

"registrationNumber": ""

// mandatory parameter, existing RegNum

(in order to create Business Card within the same Company)

// Other parameters will be ignored

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// mandatory parameter, existing Account

(in order to use existing "card.cardAccount")

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block  should contain Client data

"id": "",

// mandatory parameter, existing Client ID

(in order to use existing Business Cardholder data)

// Other parameters will be ignored

},

"deliveryAddress": { },

// parameters will be ignored

"supplementary": "false",

// FALSE is mandatory for BASE card

Example:

    "businessClient": {

        "registrationNumber": "{{registrationNumber}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "cardAccount": "{{cardAccount}}",

        "currencies": ["{{currencies}}"],

        "holder": {

            "id": "{{id}}",

        },

        "supplementary": "false",

    },

Validations:

- CreateCard will be rejected if provided "businessclient.registrationnumber", "card.holder.id" or CardAccount could not be found

- CreateCard will be rejected if provided "card.holder.id" does not own the same "businessclient.registrationnumber" as provided in businessClient part

- CreateCard will be rejected if provided "card.productCode" or "card.currencies" does not match the "card.productCode" or "card.currencies" of the found agreement


Business Supplementary Cards

CreateCard Supplementary Business[2.6]

Supplementary Business Card with new Holder

Parameters:

"businessClient": {

// mandatory block for Business Card

"registrationNumber": "",

// mandatory parameter, existing ID

(in order to create Business Card within the same Company)

// other parameters should match if used

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// mandatory parameter, existing Account

(in order to use existing "card.cardAccount")

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block should contain Client data

(Business Cardholder data)

"id": "",

// Can be absent

(in order to create new Client)

// Can be filled with own value

(in order to create new Client with own id)

"name": "",

"surname": "",

"mobilePhone": "",

// mandatory parameters

},

"deliveryAddress": { },

// parameters will be ignored

"supplementary": "true",

// True is mandatory for Supplementary card

Example:

   "businessClient": {

        "registrationNumber": "{{registrationNumber}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "cardAccount": "{{cardAccount}}"

        "currencies": ["{{currencies}}"],

        "holder": {

            "name": "{{name}}",

                "surname": "{{surname}}",

                "mobilePhone": "{{mobilePhone}}",

        },

        "supplementary": "true",

    },

Validations:

- CreateCard will be rejected If provided "card.productCode" does not match the product of the found agreement

- CreateCard will be rejected if provided "card.currencies" does not match the details of the existing card account

- CreateCard will be rejected if provided RegistrationNumber or CardAccount could not be found

- CreateCard will be rejected if provided RegistrationNumber or "card.cardAccount" do not match requested ones


CreateCard Supplementary Business[2.6]

Supplementary Business Card with existing Holder

Parameters:

"businessClient": {

// mandatory block for Business Card

"registrationNumber": ""

// mandatory parameter, existing RegNum

(in order to create Business Card within the same Company)

(Reg.num should match initial client, base Business Card owner and Supplementary Client owner)

// Other parameters will be ignored

},

"card": {

// mandatory block

"productCode": "",

// mandatory parameter

"cardAccount": "",

// mandatory parameter, existing Account

(in order to use existing "card.cardAccount")

(Account should be used from another client, planned to be used as Supplementary card owner)

"currencies": [""],

// mandatory parameter

"holder": {

// mandatory block should contain Client data

"id": "",

// mandatory parameter, existing Client ID

(in order to use existing Business Cardholder data)

("card.holder.id" should be used from initial client, base Card owner)

Other parameters will be ignored

},

"deliveryAddress": { },

// parameters will be ignored

"supplementary": "true",

// True is mandatory for Supplementary card

Example:

    "businessClient": {

        "registrationNumber": "{{registrationNumber}}",

    },

    "card": {

        "productCode": "{{productCode}}",

        "cardAccount": "{{cardAccount}}",

        "currencies": ["{{currencies}}"],

        "holder": {

            "id": "{{id}}",

        },

        "supplementary": "true",

    },

Validations:

- CreateCard will be rejected if provided "businessclient.registrationnumber" does not match the "businessclient.registrationnumber" of the Holder

- CreateCard will be rejected if provided "card.currencies" does not match the details of the existing card account

- CreateCard will be rejected if provided "card.holder.id" or CardAccount could not be found

- CreateCard will be rejected if provided "card.cardAccount" do not match requested "card.holder.id"