RequestHeader

  • The Header object is included in all server requests and contains identifying information like request ID, timestamp, protocol version, and payment integrator account ID.

  • requestId is a unique identifier for the request, limited to 100 characters and specific allowed characters.

  • requestTimestamp must be within 60 seconds of the current time and is not idempotent, meaning it changes with each retry.

  • protocolVersion specifies the version of the request being made.

  • paymentIntegratorAccountId uniquely identifies the account associated with the request, subject to contractual limitations.

Header object that is defined on all requests sent to the server.

JSON representation
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
Fields
requestId

string

REQUIRED: Unique identifier of this request.

This is a string that has a max length of 100 characters, and contains only the characters "a-z", "A-Z", "0-9", ":", "-", and "_".

requestTimestamp

object (Timestamp)

REQUIRED: Timestamp of this request. The receiver must verify that this timestamp is ± 60s of 'now', and reject the request if it is not. This request timestamp is not idempotent upon retries.

protocolVersion

object (Version)

REQUIRED: The version of this request.

paymentIntegratorAccountId

string

REQUIRED: Identifies a unique account with contractual constraints.