Activate Invoice
  • 04 Apr 2022
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Activate Invoice

  • Dark
    Light
  • PDF

Article summary

Use the Activate Invoice web service to activate invoices that are only inactive on the PayOne SmartLink interface. 

Syntax

POST rest/InvoicesService/activateInvoice

Service Specifications

Property and Information
  • Endpoint: activateInvoice 
  • Name: Activate Invoice Service
  • Method: POST
  • Input Parameters: invoice, a JSON formatted object.
  • Parameters Type: Form parameters that need to be set in the body of the HTTP request.
  • Path: rest/InvoicesService/activateInvoice. The path is prefixed with the SmartLink Context root.

Input Parameters

ParameterDescription
merchantID
required
An alphanumeric value that represents the Merchant ID. The Payment Gateway operation team provides this value based on the merchant enrollment. 
  • Field Type: Alphanumeric
  • Length: 30
  • Sample Data: abcMerchant
authenticationToken 
required
An alphanumeric value that represents the Authentication Token. The Payment Gateway operation team provides this value based on the merchant enrollment. 
  • Field Type: Alphanumeric
  • Length: 255
  • Sample Data: ODYxNTY2ZTI4MmJmMzUyM2VhYmUyMGYx
invoiceID
required
An alphanumeric value that represents the Invoice Id that must be unique per invoice.
  • Field Type: Alphanumeric
  • Length: 60
  • Sample Data: 50142985

Sample Request

Activate Invoice service request contains the details of the invoice desired to be activated.

It is in JSON format that contains the following details:

  • merchantID
  • authenticationToken
  • invoiceID
invoice={ "merchantID":"abcMerchant", "invoiceID":"50142985", "authenticationToken":"ODYxNTY2ZTI4MmJmMzUyM2VhYmUyMGYx" }

Output Parameters

ParameterDescription
invoiceID
required
An alphanumeric value that represents the Invoice Id that must be unique per invoice. The value is the same as the  Invoice Id sent in the request.
  • Field Type: Alphanumeric
  • Length: 60
  • Sample Data: 50142985
authenticationToken
required
An alphanumeric value that represents the Authentication Token. The Payment Gateway operation team provides this value based on the merchant enrollment. 
  • Field Type: Alphanumeric
  • Length: 255
  • Sample Data: ODYxNTY2ZTI4MmJmMzUyM2VhYmUyMGYx
status
required

A value that represents the status description of the activation process

  • Field Type: Alphanumeric
  • Length: 265
  • Sample Data: Invoice is activated successfully. 

Sample Response

Activate Invoice service returns the response in JSON format.

The returned response contains the following details:

  •  invoiceID 
  • status
  • authenticationToken
{ "invoiceID":"50142985", "status":"Invoice is activated successfully", "authenticationToken":"ODYxNTY2ZTI4MmJmMzUyM2VhYmUyMGYx" }