Authorize Points Transaction

Beta
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