Set Account for Rewards Deposit
This endpoint allows a partner to set or update the destination account for partner-level rewards payouts. Use it to control which financial account receives accumulated reward points when they are redeemed or distributed. Partners can update this account at any time to redirect future reward deposits.
Endpoint
POST /api/Partners/accountForPoints
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 onboarding a new partner and an account must be designated for rewards deposits, or when an existing partner needs to redirect reward payouts to a different account. This is a partner-level configuration and applies to all accumulated rewards at the partner scope.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| profileId | integer (int32) | No | The identifier of the partner profile for which to set the rewards deposit account. |
Response
200 OK
A successful response confirms the rewards deposit account has been set or updated. No response body fields are returned beyond the status.
{}Error Codes
| Code | When it happens |
|---|---|
| 400 | Missing required fields or validation error |
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions |
| 404 | Resource not found |
| 500 | Internal server error |
Common Mistakes
- Omitting the
profileIdquery parameter when multiple partner profiles exist, which may result in updating the wrong profile's rewards account. - Using an expired or missing Bearer token, which returns a 401 error.
- Sending the request without a
Content-Type: application/jsonheader when including a body payload.
Related Endpoints
GET /api/Partners/accountForPoints— Retrieve the currently configured rewards deposit account for a partner profile.POST /api/Partners/rewards/redeem— Redeem accumulated partner rewards to the configured deposit account.
Example
curl -X POST "https://api.banking.netevia.dev/api/Partners/accountForPoints?profileId=12345" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" 200Success
