Set Account for Rewards Deposit

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

ParameterTypeRequiredDescription
profileIdinteger (int32)NoThe 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

CodeWhen it happens
400Missing required fields or validation error
401Token missing, expired, or invalid
403Insufficient permissions
404Resource not found
500Internal server error

Common Mistakes

  • Omitting the profileId query 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/json header 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"
Query Params
int32
Response
200

Success

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here!