Checks if specific points of a customer can be transferred to another customer.
Checks if specific points of a customer can be transferred to another customer. You can also issue OTP
that is used to authenticate customer to transfer points ( pointsTransfer
API ). By default, the value is set to false. OTP is not mandatory for points transfer and can be used for security purposes.
Notes
- Points added during customer creation cannot be transferred, points rewarded through transaction are transferable.
- This API is applicable only for individual-to-individual transfers within the Intouch platform. It does not support group-to-group transfers.
- For detailed information about the APIs and for hands-on testing, refer to the API overview documentation and step-by-step guide on making your first API call
Example request
curl --location 'https://eu.api.capillarytech.com/v2/points/isTransferrable' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic bWFka2YQ==' \
--header 'Cookie: _cfuvid=IEacVBB7xCaQXaYZNjqhVgGFNNBE1wcNyx6O5vnh4cA-1759831634361-0.0.1.1-604800000' \
--data '{
"pointsTobeTransferred":1,
"groupProgramTransfer": false,
"programId": 973,
"fromCustomerIdentifier": {
"type": "MOBILE",
"value": "9777785206"
},
"toCustomerIdentifier": {
"type": "MOBILE",
"value": "9777785207"
},
"issueOtp":false
}'
Prerequisites
- The config ALLOW_POINTS_TRANSFER should be enabled for the org. To enable this, create a JIRA ticket to the Product Support team.
Example response
{
"data": [
{
"pointsTobeTransferred": 1.0,
"transferFrom": {
"id": 564955302,
"profiles": [
{
"firstName": "testgrp4",
"lastName": "testgrpv2",
"attribution": {
"createDate": "2025-02-18T05:14:32Z",
"createdBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedDate": "2025-06-02T11:26:52Z"
},
"fields": {},
"allFields": {},
"identifiers": [
{
"type": "mobile",
"value": "919777785206"
},
{
"type": "externalId",
"value": "434548"
},
{
"type": "email",
"value": "[email protected]"
}
],
"commChannels": [
{
"type": "mobile",
"value": "919777785206",
"primary": true,
"verified": false,
"meta": {
"residence": false,
"office": false
},
"attributes": {}
},
{
"type": "email",
"value": "[email protected]",
"primary": true,
"verified": false,
"meta": {
"residence": false,
"office": false
},
"attributes": {}
}
],
"source": "INSTORE",
"userId": 564955302,
"accountId": "",
"conflictingProfileList": [],
"autoUpdateTime": "2025-10-07T10:15:10Z",
"identifiersAll": [
{
"type": "mobile",
"value": "919777785206"
},
{
"type": "externalId",
"value": "434548"
},
{
"type": "email",
"value": "[email protected]"
}
]
}
],
"loyaltyInfo": {
"loyaltyType": "loyalty",
"attributionV2": {
"createDate": "2025-02-18T05:14:32Z",
"createdBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedDate": "2025-06-02T11:26:52Z"
},
"lifetimePurchases": 50000.000
},
"segments": {},
"extendedFields": {}
},
"transferTo": {
"id": 564955411,
"profiles": [
{
"firstName": "testgrp5",
"lastName": "testgrpv2",
"attribution": {
"createDate": "2025-02-18T05:53:34Z",
"createdBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedDate": "2025-06-02T11:27:06Z"
},
"fields": {},
"allFields": {},
"identifiers": [
{
"type": "mobile",
"value": "919777785207"
},
{
"type": "email",
"value": "[email protected]"
},
{
"type": "externalId",
"value": "434549"
}
],
"commChannels": [
{
"type": "mobile",
"value": "919777785207",
"primary": true,
"verified": false,
"meta": {
"residence": false,
"office": false
},
"attributes": {}
},
{
"type": "email",
"value": "[email protected]",
"primary": true,
"verified": false,
"meta": {
"residence": false,
"office": false
},
"attributes": {}
}
],
"source": "INSTORE",
"userId": 564955411,
"accountId": "",
"conflictingProfileList": [],
"autoUpdateTime": "2025-10-07T10:15:10Z",
"identifiersAll": [
{
"type": "mobile",
"value": "919777785207"
},
{
"type": "email",
"value": "[email protected]"
},
{
"type": "externalId",
"value": "434549"
}
]
}
],
"loyaltyInfo": {
"loyaltyType": "loyalty",
"attributionV2": {
"createDate": "2025-02-18T05:53:34Z",
"createdBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedBy": {
"id": 75155295,
"code": "sant.p_123",
"name": "sant.p_123",
"type": "TILL",
"referenceId": -1,
"default": false
},
"modifiedDate": "2025-06-02T11:27:06Z"
},
"lifetimePurchases": 50000.000
},
"segments": {},
"extendedFields": {}
},
"transferrable": true
}
],
"warnings": [],
"errors": []
}
Response Parameters
Parameter | Data Type | Description |
---|---|---|
data | Array | Contains details of the points transfer request. |
pointsTobeTransferred | Float | Number of points to be transferred. |
transferFrom | Object | Details of the customer transferring the points. |
| Long | Unique identifier of the customer transferring points. |
| Array | List of profile details of the transferring customer. |
-- firstName | String | First name of the transferring customer. |
-- lastName | String | Last name of the transferring customer. |
-- identifiers | Array | List of identifiers for the transferring customer (e.g., email, mobile, external ID). |
-- commChannels | Array | List of communication channels (email, mobile) for the transferring customer. |
loyaltyInfo | Object | Loyalty details of the transferring customer. |
| String | Type of loyalty program. |
| Float | Total purchases made by the transferring customer. |
transferTo | Object | Details of the customer receiving the points. |
| Long | Unique identifier of the customer receiving points. |
| Array | List of profile details of the receiving customer. |
-- firstName | String | First name of the receiving customer. |
-- lastName | String | Last name of the receiving customer. |
-- identifiers | Array | List of identifiers for the receiving customer (e.g., email, mobile, external ID). |
-- commChannels | Array | List of communication channels (email, mobile) for the receiving customer. |
| Object | Loyalty details of the receiving customer. |
-- loyaltyType | String | Type of loyalty program. |
-- lifetimePurchases | Float | Total purchases made by the receiving customer. |
transferrable | Boolean | Indicates if the points transfer is possible. |
warnings | Array | List of warnings, if any. |
errors | Array | List of errors, if any. |
API specific error codes
Error code | Description | Reason |
---|---|---|
885 | Invalid program id passed | The program id provided is invalid or unsupported. |
8013 | Invalid identifier passed | The costumer id was invalid or unsupported |
8015 | Costumer not found for the given identifiers | Customer id provided is invalid or not found. |
3316 | Group redemption action executed for non-group redemption payload. | Group redemption action is unsupported for non-group redemption payload. |