TOtogaihq
Accounts

Initiate a purchase

Changed on

This API let’s you to initiate a purchase for an account

post/accounts/{account_id}/purchases

Request

  • Base URL
    https://api.togai.com
  • Auth
    HTTP bearer

Path parameters

account_idstring required
Example:ACC00001

account_id corresponding to an account

Request body

pricePlanIdstring

Id of the price plan, Required for ENTITLEMENT_GRANT, ASSOCIATION purchase

quantityinteger
rateCardQuantitiesobject
idempotencyKeystring
effectiveFromstring date
effectiveUntilstring date
expiryDatestring date-time
type'ENTITLEMENT_GRANT' | 'ASSOCIATION' | 'WALLET_TOPUP' | 'PREPAID'

Specifies whether this purchase is for granting entitlements or for an association or for wallet topup or prepaid purchase. If left null, ENTITLEMENT_GRANT is taken as default

Response

Response for initiation of a purchase of entitlement plan for an account

idstring required
accountIdstring required
pricePlanIdstring

Id of the price plan, Required for ENTITLEMENT_GRANT, ASSOCIATION purchase

quantityinteger
rateCardQuantitiesobject
idempotencyKeystring
pricePlanVersioninteger
createdAtstring date-time required
updatedAtstring date-time
effectiveFromstring date
effectiveUntilstring date
expiryDatestring date-time
pricenumber
invoiceIdstring
invoiceCurrencystring
status'SUCCESS' | 'FAILURE' | 'PENDING' | 'IN_PROGRESS' | 'PROPOSAL_ACTIVE' | 'PROPOSAL_APPROVED' | 'PROPOSAL_DECLINED' | 'PROPOSAL_EXPIRED' required

Status of the purchase

type'ENTITLEMENT_GRANT' | 'ASSOCIATION' | 'WALLET_TOPUP' | 'PREPAID' required

Specifies whether this purchase is for granting entitlements or for an association or for wallet topup or prepaid purchase. If left null, ENTITLEMENT_GRANT is taken as default

commentstring

Changes

  • 2b8be460ec6aRevision changes
    • info

      added the new optional request property ///

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /////// to the response with the status

  • 3135bb8c67b3Revision changes
    • info

      added the new optional request property ///

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /////// to the response with the status