Transfer points between customers

Transfer Points Between Customers

This endpoint allows partners to transfer reward points from one business customer account to another within the Netevia platform. It is typically used to support internal points management, loyalty program adjustments, and customer service operations. Partners can initiate transfers either manually or programmatically as part of promotional campaigns or reward distribution workflows.

Endpoint

POST /api/Partners/Transfer

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when a partner needs to move reward points between two business customer accounts — for example, redistributing points as part of a loyalty promotion, correcting a points balance on behalf of a customer, or fulfilling a points transfer request initiated by a customer service workflow. This endpoint is restricted to business customers, as rewards are a business-only feature on the Netevia platform.

Request Body

Field	Type	Required	Description
fromProfileId	integer (int32)	Yes	The profile ID of the customer from whom points will be deducted
toProfileId	integer (int32)	Yes	The profile ID of the customer who will receive the points
points	integer (int32)	Yes	The number of reward points to transfer. Minimum: 100. Maximum: 2,147,483,647

{
  "fromProfileId": 10045,
  "toProfileId": 10087,
  "points": 500
}

Response

200 OK

Field	Type	Description
(success indicator)	—	A 200 status code confirms the transfer was successfully processed

{}

Error Codes

Code	When it happens
400	Missing required fields, points value below minimum (100), or invalid profile IDs
401	Token missing, expired, or invalid
403	Insufficient permissions to perform partner-level transfer operations
404	One or both profile IDs not found
500	Internal server error

Common Mistakes

Sending a points value below the minimum of 100 — the API will reject the request with a 400 error
Using the same value for fromProfileId and toProfileId — transfers must be between two distinct customer accounts
Attempting to transfer more points than the source account holds — ensure the sending customer has a sufficient reward balance before initiating the transfer
Using a personal customer profile ID — rewards and partner-level point transfers apply to business customers only

Related Endpoints

GET /api/Partners/Rewards — retrieve reward point balances for a customer
POST /api/Rewards/Redeem — redeem reward points to a financial account
POST /api/Rewards/Transfer — customer-initiated reward transfer between business customers

Example

curl -X POST https://api.banking.netevia.dev/api/Partners/Transfer \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fromProfileId": 10045,
    "toProfileId": 10087,
    "points": 500
  }'