Client Registration

This API assigns a unique receiving institution to a client which will be sent in every request to Postilion.

Request Message description


Field #Field nameData typeMax lengthRequiredDescription
1clientIdstringtruethe client id (name e.g isw-portal)
2riidstring11truereceiving institution id
POST https://payment-api.k8.isw.la/card-management/api/v1/client/register
Authorization = Bearer Token

Sample Request

{
    "clientId":"30754",
    "riid":"1050727084"
}

Response message description


Field #Field nameDescription
1codeInternal Response Code
2descriptionSuccessful or Error Message
3clientIdthe client id (name e.g isw-portal)
4riidreceiving institution id

Sample Response (Success)

{
    "code": "200",
    "description": "Successful",
    "clientId": "30754",
    "riid": "1050727084"
}

Sample Response (Failure)

{
    "code": "400",
    "description": "Client already registered.",
    "correlationId": "73c0629328a947c39db93d4f1b869d80"
}