Authorize Points Transaction
BetaPOST
https://api.npretail.app/:tenant/:environment/:company/membership/:membershipId/points/auth
Creates an authorization for a points adjustment. This reserves the points for a specified period and must be finalized.
Path parameters
tenantstringRequired
Your Entra Tenant ID. More details.
environmentstringRequired
Your Business Central Environment. More details.
companystringRequired
Your Business Central Company. More details.
membershipIdUUIDRequired
Unique identifier for a membership.
Headers
AuthorizationstringRequired
Bearer authentication of the form Bearer <token>, where token is your auth token.
x-api-versiondateOptional
Used for API versioning. More details.
Request
This endpoint expects an object.
requestIdUUIDRequired
A unique identifier for the request. If you send the same requestId twice, it will be guaranteed to only trigger once.
pointsAdjustmentintegerRequired
The number of points to adjust. Use a negative value for deductions.
reasonstringRequired
A description of why the points are being adjusted.
timeoutPeriodintegerRequired
The duration in seconds for which the authorization is valid.
externalReferenceNostringRequired
Your external reference number, such as a POS Receipt number, invoice number etc.
externalSystemIdentifierstringRequired
An identifier of your external system. This together with the entra app name identifies the external system that is making the operation.
externalSystemUserIdentifierstringRequired
An identifier for the user in the external system, e.g. a salesperson code in an external POS or a user ID in a customer support tool.
AutoFinalizebooleanRequired
if set to true, you don't need to finalize manually. Relevant when assigning points for completed sales with no natural two step transaction required.
customerNostringOptional
An optional customer no. if using reconciliation in the point master node.
Response
This endpoint returns an object.
transactionIdUUID
A unique identifier for a points transaction.
statusenum
Allowed values:
expiresAtdatetime