Tags:
- Phase›Realized
Custom Gateway API Endpoint
Paths
/v1/customers/profiles/basic
Retrieve customer particulars.
This API is used to retrieve customer particulars
Access token to authenticate your request.
128 bit random UUID generated uniquely for every request.
Content-Type that are acceptable for the response.
Client ID generated during application registration.
Successful operation.
Type | Code | Details |
invalid | invalidRequest | Missing or invalid parameters |
error | unAuthorized | Authorization credential is missing or invalid |
error | accessNotConfigured | Access is not configured for this resource |
error | resourceNotFound | Empty resource/resource not found |
fatal | serverUnavailable | The request failed due to an internal error |
/v1/customers/profiles
Retrieve customer complete personal details
This API is used to retrieve customer details including personal particulars ,address,phones and emails details
Access token to authenticate your request.
128 bit UUID that you generate for every request
Content-Type that are acceptable for the response
Client ID generated during application registration.
Successful operation.
Type | Code | Details |
invalid | invalidRequest | Missing or invalid parameters |
error | unAuthorized | Authorization credentials are missing or invalid |
error | accessNotConfigured | Access is not configured for this resource |
error | resourceNotFound | Empty resource/resource not found |
fatal | serverUnavailable | The request failed due to an internal error |
/v1/customers/profiles/emails
Update Customer Email Address
This API is used to update customer email address
Access token to authenticate your request
128 bit random UUID generated uniquely for every request
Content-Type that are acceptable for the response
Client ID generated during application registration
application/json
Successful operation
Type | Code | Details |
invalid | invalidRequest | Missing or invalid Parameters |
error | exceededMaximumAllowedEmails | Exceeded maximum allowed emails |
error | unAuthorized | Authorization credentials are missing or invalid |
error | accessNotConfigured | The request operation is not configured to access this resource |
error | resourceNotFound | Empty resource/resource not found |
fatal | serverUnavailable | The request failed due to an internal error |
To retrieve customer email address details.
This API is used to retrieve customer email address details.
Access token to authenticate your request.
128 bit random UUID generated uniquely for every request.
Content-Type that are acceptable for the response.
Client ID generated during application registration.
Successful operation.
Type | Code | Details |
invalid | invalidRequest | Missing or invalid parameters |
error | unAuthorized | Authorization credential is missing or invalid |
error | accessNotConfigured | Access is not configured for this resource |
error | resourceNotFound | Empty resource/resource not found |
fatal | serverUnavailable | The request failed due to an internal error |
/v1/customers/profiles/addresses
Update customer address details
This API is used to update customer address details
Access token to authenticate your request
128 bit random UUID generated uniquely for every request
Content-Type that are acceptable for the response
Client ID generated during application registration
application/json
Successful operation
Type | Code | Details |
invalid | invalidRequest | Missing or invalid Parameters |
error | exceededMaximumAllowedAddresses | Exceeded maximum allowed addresses |
error | unAuthorized | Authorization credentials are missing or invalid |
error | accessNotConfigured | The request operation is not configured to access this resource |
fatal | serverUnavailable | The request failed due to an internal error |
API summary
API description
Access token to authenticate your request.
128 bit UUID that you generate for every request
Content-Type that are acceptable for the response
Client ID generated during application registration.
Successful operation.
Type | Code | Details |
invalid | invalidRequest | Missing or invalid parameters |
error | unAuthorized | Authorization credentials are missing or invalid |
error | accessNotConfigured | Access is not configured for this resource |
error | resourceNotFound | Empty resource/resource not found |
fatal | serverUnavailable | The request failed due to an internal error |
/v1/customers/profiles/phoneNumbers
Update Customer Phone Number
This API is used to update customer phone number
Access token to authenticate your request
128 bit random UUID generated uniquely for every request
Content-Type that are acceptable for the response
Client ID generated during application registration
application/json
Successful operation
Type | Code | Details |
invalid | invalidRequest | Missing or invalid Parameters |
error | exceededMaximumAllowedPhones | Exceeded maximum allowed phones |
error | unAuthorized | Authorization credentials are missing or invalid |
error | accessNotConfigured | The request operation is not configured to access this resource |
error | resourceNotFound | Empty resource/resource not found |
fatal | serverUnavailable | The request failed due to an internal error |
To retrieve customer phone numbers
This API is used to retrieve customer phone numbers.
Access token to authenticate your request.
128 bit random UUID generated uniquely for every request.
Content-Type that are acceptable for the response.
Client ID generated during application registration.
Successful operation.
Type | Code | Details |
invalid | invalidRequest | Missing or invalid parameters |
error | unAuthorized | Authorization credential is missing or invalid |
error | accessNotConfigured | Access is not configured for this resource |
error | resourceNotFound | Empty resource/resource not found |
fatal | serverUnavailable | The request failed due to an internal error |
Definitions
{
"properties": {
"phones": {
"type": "array",
"items": {
"$ref": "#/definitions/Phone"
}
}
}
}
{
"properties": {
"addressList": {
"type": "array",
"items": {
"$ref": "#/definitions/Address"
}
}
}
}
{
"properties": {
"emailAddress": {
"description": "Email address of the customer",
"type": "string",
"example": "javier123@yahoo.com"
},
"emailType": {
"description": "The type of email. This is a reference data field. Please use /v1/apac/utilities/referenceData/{emailType} resource to get valid value of this field with description. You can use emailType as the referenceCode parameter to retrieve the values ",
"type": "string",
"example": "PERSONAL"
},
"preferredEmailFlag": {
"description": "Flag to indicate the preferred Email.",
"type": "boolean",
"example": "true"
}
},
"required": [
"emailAddress"
]
}
{
"properties": {
"city": {
"description": "City",
"type": "string",
"example": "SINGAPORE"
},
"addressType": {
"description": "Type of the address. This is a reference data field. Please use /v1/apac/utilities/referenceData/{addressType} resource to get valid value of this field with description. You can use addressType as the referenceCode parameter to retrieve the values.",
"type": "string",
"example": "PRIMARY_ADDRESS"
},
"postalCode": {
"description": "Postal code the mailing address",
"type": "string",
"example": "520189"
},
"addressline3": {
"description": "address line3 of the mailing address",
"type": "string",
"example": "Orchard Avenue 2"
},
"addressline2": {
"description": "address line2 of the mailing address",
"type": "string",
"example": "#99-99 MACDONALD HOUSE"
},
"addressline1": {
"description": "address line1 of the mailing address",
"type": "string",
"example": "40A ORCHARD ROAD"
},
"state": {
"description": "State",
"type": "string",
"example": "SINGAPORE"
},
"countryName": {
"description": "Country Name",
"type": "string",
"example": "SINGAPORE"
},
"addressline4": {
"description": "address line4 of the mailing address",
"type": "string",
"example": "Street 65"
}
},
"required": [
"addressline1",
"addressType"
]
}
{
"properties": {
"phoneType": {
"description": "The type of phone. This is a reference data field. Please use /v1/apac/utilities/referenceData/{phoneType} resource to get valid value of this field with description. You can use phoneType as the referenceCode parameter to retrieve the values",
"type": "string",
"example": "HOME"
},
"areaCode": {
"description": "Area code of telephone number",
"type": "string",
"example": "O"
},
"extension": {
"description": "Extension of telephone number",
"type": "string",
"example": "O"
},
"phoneNumber": {
"description": "The phone number of a customer",
"type": "string",
"example": "4567234512"
},
"phoneCountryCode": {
"description": "Country code in ISO 3166 format",
"type": "string",
"example": "34"
}
},
"required": [
"phoneType",
"phoneNumber"
]
}
{
"properties": {
"names": {
"type": "array",
"items": {
"$ref": "#/definitions/Name"
}
},
"gender": {
"description": "Gender/Sex. Valid values are MALE, FEMALE for individual customer types and OTHERS for corporate customers.This is a reference data field. Please use /v1/apac/utilities/referenceData/{gender} resource to get valid value of this field with description. You can use gender as the referenceCode parameter to retrieve the values.",
"type": "string"
},
"prefix": {
"description": "The prefix of the customer s name.",
"type": "string",
"example": "Mr."
},
"suffix": {
"description": "The suffix of the customer s name.",
"type": "string",
"example": "III"
}
}
}
{
"properties": {
"emails": {
"type": "array",
"items": {
"$ref": "#/definitions/Email"
}
}
}
}
{
"properties": {
"customerType": {
"description": "Type of the customer. This is applicable only for Individual customers.This is a reference data field. Please use /v1/apac/utilities/referenceData/{customerType} resource to get valid value of this field with description. You can use customerType as the referenceCode parameter to retrieve the values.",
"type": "string",
"example": "INDIVIDUAL"
},
"customerParticulars": {
"$ref": "#/definitions/CustomerParticulars"
},
"customerSegment": {
"description": "Type of the customer. This is applicable only for Individual customers.This is a reference data field. Please use /v1/apac/utilities/referenceData/{customerSegment} resource to get valid value of this field with description. You can use customerSegment as the referenceCode parameter to retrieve the values.",
"type": "string",
"example": "BLUE"
}
},
"required": [
"customerSegment"
]
}
{
"properties": {
"emails": {
"type": "array",
"items": {
"$ref": "#/definitions/Email"
}
},
"customerType": {
"description": "Type of the customer. This is applicable only for Individual customers.This is a reference data field. Please use /v1/apac/utilities/referenceData/{customerType} resource to get valid value of this field with description. You can use customerType as the referenceCode parameter to retrieve the values.",
"type": "string",
"example": "INDIVIDUAL"
},
"customerParticulars": {
"$ref": "#/definitions/CustomerParticulars"
},
"customerSegment": {
"description": "Type of the customer. This is applicable only for Individual customers.This is a reference data field. Please use /v1/apac/utilities/referenceData/{customerSegment} resource to get valid value of this field with description. You can use customerSegment as the referenceCode parameter to retrieve the values.",
"type": "string",
"example": "BLUE"
},
"addressList": {
"type": "array",
"items": {
"$ref": "#/definitions/Address"
}
},
"phones": {
"type": "array",
"items": {
"$ref": "#/definitions/Phone"
}
}
},
"required": [
"customerSegment"
]
}
{
"properties": {
"code": {
"description": "Error code which qualifies the error",
"type": "string"
},
"details": {
"description": "Human readable explanation specific to the occurrence of the problem",
"type": "string"
},
"location": {
"description": "The name of the field that resulted in the error",
"type": "string"
},
"type": {
"description": "Invalid - Request did not confirm to the specification and was unprocessed and rejected. Please fix the value and try again",
"type": "string",
"enum": [
"error",
"warn",
"invalid",
"fatal"
]
},
"moreInfo": {
"description": "URI to human readable documentation of the error",
"type": "object"
}
},
"required": [
"type",
"code"
]
}
{
"properties": {
"nameType": {
"description": "Type of the name. This is a reference data field. Please use /v1/apac/utilities/referenceData/{nameType} resource to get valid value of this field with description. You can use nameType as the referenceCode parameter to retrieve the values.",
"type": "string",
"example": "LOCAL_NAME"
},
"firstName": {
"description": "The first name of the customer. Also known as first name",
"type": "string",
"example": "Javier"
},
"lastName": {
"description": "The last name of the customer. Also known as last name",
"type": "string",
"example": "de Cuellar"
},
"fullName": {
"description": "Full name of the customer.",
"type": "string",
"example": "Javier Perez de Cuellar"
},
"middleName": {
"description": "Middle name of the customer.",
"type": "string",
"example": "Perez"
}
},
"required": [
"firstName"
]
}