Skip to content

Update Customer

Request URL

POST /condor/customer/update (deprecated)

Description

This endpoint is deprecated. Instead of using /condor endpoints, it is recommended to use /ibis endpoints. Ibis endpoints support credit-card issuing, debit-card issuing, and vAccount issuing.

This endpoint is used to update or add customer information. The "customerId" property is required for a successful response. Optional properties include "firstName", "lastName", "gender", "dateOfBirth", "email", the "addresses" array, and the "phones" array. Use cases may include instances where a customer needs to change their name, add a new phone number, update their email address, etc.

Including any properties other than those listed will result in an error. Note that you may NOT use this endpoint to update or add identification document information.

Required Properties Description Schema Example Values
customerId Customer ID in connectFi String "csta_6clNH3W2pBehujY8mpTCU8"
Optional Properties Description Schema Example Values
firstName First name of customer String "Jessie"
lastName Last name of customer String "Testman"
gender Customer's gender ("M" or "F") String "M" or "F"
dateOfBirth Customer's date of birth in YYYY-MM-DD format String, regex pattern "^\d{4}-\d{2}-\d{2}$" "1978-10-25"
email Customer's email address String, regex pattern "^(.+)@(.+)$" "bb@bb.be"
addresses Array of objects representing customer's addresses Array [{//address1}, {//address2}, {//etc.}], See Address Object below
phones Array of objects representing customer's phone numbers Array [{//phone1}, {//phone2}, {//etc.}], See Phone Object below

Address Object

Properties Description Schema Example Values
type Type of address (required) String "PRIMARY" or "SECONDARY"
addressLine1 Customer's address line 1 (required) String "123 Some Str."
addressLine2 Customer's address line 2 (optional) String "Apt A123"
city Customer's city (required) String "Mycityname"
state Customer's state (required) String "PA"
postalCode Customer's postal code (required), each # in the example should be replaced with a digit 0-9 String "#####"
countryCodeA3 Customer's country (required) String "USA"

Phone Object

Properties Description Schema Example Values
type Type of phone number (required) String "MOBILE" or "LANDLINE"
phoneNumber Customer's 6 to 12 digit phone number (required), each # in the example should be replaced with a digit 0-9 String "##########"
countryDialingCode Customer's 1 to 4 digit country dialing code (optional) String "01"

Request Body

HEADERS

{
    "Content-Type": "application/json",
    "x-connectfi-token": "a long random string" //Authorization token received from /auth/get-token request
}

REQUEST BODY

{
    "customerId" : "csta_6clNH3W2pBehujY8mpTCU8", //customer ID in connectFi
    "firstName" : "Jessie", //Optional property - will be updated if different from existing property value. Otherwise, existing value will remain the same.
    "lastName" : "Testman", //Optional property - will be updated if different from existing property value. Otherwise, existing value will remain the same.
    "gender" : "M", //Optional property - will be updated if different from existing property value. Otherwise, existing value will remain the same.
    "dateOfBirth" : "1978-10-25", //Optional property - will be updated if different from existing property value. Otherwise, existing value will remain the same. YYYY-MM-DD format
    "email" : "bb@bb.be", //Optional property - will be updated if different from existing property value. Otherwise, existing value will remain the same.
    "addresses" : [ //Optional property - will be updated if different from existing property value. Otherwise, existing value will remain the same. Note that multiple addresses of the same "type" are not allowed and will result in an error.
        {
            "type": "PRIMARY",
            "addressLine1": "123 Some Str.",
            "city": "Mycityname",
            "countryCodeA3": "USA",
            "postalCode": "#####", //a postal code, ##### is used as a placeholder here for documentation purposes
            "stateCode": "PA"
        },
        {
            "type": "SECONDARY",
            "addressLine1": "124 Some Str.",
            "city": "Mycityname",
            "countryCodeA3": "USA",
            "postalCode": "#####", //a postal code, ##### is used as a placeholder here for documentation purposes
            "stateCode": "PA"
        }
    ],
    "phones": [ //Optional property - will be updated if different from existing property value. Otherwise, existing value will remain the same. Note that multiple phone elements of the same "type" are not allowed and will result in an error.
        {
            "type": "MOBILE",
            "phoneNumber": "##########", //a phone number, "##########", is used as a placeholder here for documentation purposes
            "countryDialingCode": "01"
        }
    ] 
}

Successful Response Example

200 (HTTP response status code) -- Success, information was updated and/or added

{
    "code": "0", //Success
    "data": {
        "condorCustomer": {
            "first_name": "Jessie",
            "last_name": "Testman",
            "gender": "M",
            "email": "bb@bb.be",
            "phone_details": [
                {
                    "phone_type": "MOBILE", //May only have one of each phone type (you cannot have two phone numbers listed as type "MOBILE", etc.) 
                    "country_dialing_code": 1,
                    "phone_number": "##########", //a phone number, "##########", is used as a placeholder here for documentation purposes
                }
            ],
            "date_of_birth": "1978-10-25",
            "addresses": [
                {
                    "address_type": "PRIMARY", //May only have one of each address type (you cannot have two addresses listed as type "PRIMARY", etc.)
                    "address1": "123 Some Str.",
                    "city": "Mycityname",
                    "region": "PA",
                    "postal_code": "#####", //a postal code, ##### is used as a placeholder here for documentation purposes
                    "country": "USA"
                },
                {
                    "address_type": "SECONDARY", //May only have one of each address type (you cannot have two addresses listed as type "SECONDARY", etc.)
                    "address1": "124 Some Str.",
                    "city": "Mycityname",
                    "region": "PA",
                    "postal_code": "#####", //a postal code, ##### is used as a placeholder here for documentation purposes
                    "country": "USA"
                }
            ],
            "identification_docs": [ //Existing identification documents will returned in the response, even though the /condor/customer/update endpoint will not allow you to update or add identification document information.
                {
                    "identification_type": "DRIVING LICENSE",
                    "identification_value": "#########", //a Driver's License Number, ######### is used as a placeholder here for documentation purposes
                    "identification_issuance_country": "USA",
                    "identification_issuance_region": "Pennsylvania",
                    "identification_expiry_date": "2023-04-08"
                },
                {
                    "identification_type": "SSN",
                    "identification_value": "#########", //a 9 digit Social Security Number, ######### is used as a placeholder here for documentation purposes
                    "identification_issuance_country": "USA"
                }
            ],
            "customerId": "csta_6clNH3W2pBehujY8mpTCU8" //customer ID in connectFi
        }
    }
}

Errors

400 (HTTP response status code) -- Duplicate address/phone type found

In this example, a request to include two "PRIMARY" type addresses was made. You may only have one of a specific type of address or phone number. If the request body address array or phone array contains duplicate type values, an error will be returned.

{
    "code": "extCondor",
    "subCode": "C0900",
    "context": {
        "title": "cardholdersUpdate"
    },
    "message": "Duplicate address type found."
}

400 (HTTP response status code) -- Must have required property

While all properties other than "customerId" are optional, if you DO include a property such as "addresses", all required parts of that property must be present. In this example, a request was made to update the addresses array, but the new address was missing the required address property "stateCode".

{
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "/addresses/0",
            "schemaPath": "#/definitions/address/required",
            "keyword": "required",
            "params": {
                "missingProperty": "stateCode"
            },
            "message": "must have required property 'stateCode'"
        }
    ]
}

400 (HTTP response status code) -- Must not have additional properties

The "customerId" property should be present when making this request. Optional properties include "firstName", "lastName", "gender", "dateOfBirth", "email", the "addresses" array, and the "phones" array. Any other property values present will result in an error. In this example, an additional property "cardAttributes" was included in the request.

Note: You may not use this endpoint to update or add identification document information.

{
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "",
            "schemaPath": "#/additionalProperties",
            "keyword": "additionalProperties",
            "params": {
                "additionalProperty": "cardAttributes"
            },
            "message": "must NOT have additional properties"
        }
    ]
}