TXAPI v1.0.4.x

TXAPI OpenAPI specification

Authentication

• HTTP Authentication, scheme: basic

Default

GETGet card

GET /tx/v1/card

Retrieves the card details by unique card reference. Use the reference parameter to specify the card to return. For security reasons, PAN is not fully visible for the card object returned (PAN is returned masked).

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card

Example responses

200 Response

{
  "ref": {
    "id": 13579,
    "rid": "CRDRID24680"
  },
  "className": "Smart cards",
  "holder": {
    "id": 1746,
    "rid": "PRID73"
  },
  "issuingContractType": {
    "id": 97548,
    "rid": "CTRID975"
  },
  "issuingContract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "financialContract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "mainCard": {
    "id": 13579,
    "rid": "CRDRID24680"
  },
  "product": {
    "id": 22,
    "rid": "CPRID22"
  },
  "design": {
    "id": 12,
    "rid": "DESRID12"
  },
  "panMask": "777777******6543",
  "mbr": 0,
  "status": "string",
  "lifePhaseRid": "LCRID_ATBRANCH",
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "tdsEnrollment": true,
  "logistics": {
    "deliveryBranchName": "Branch 1",
    "deliveryAddress": {
      "zip": "NG71AE",
      "country": 0,
      "region": "CAL",
      "regionRid": "string",
      "area": "Nord",
      "areaRid": "string",
      "city": "Homeburg",
      "cityRid": "string",
      "street": "Broadway",
      "streetRid": "string",
      "house": 15,
      "building": 2,
      "construction": 1,
      "flat": 4,
      "addressInCity": null,
      "addressInCountry": null,
      "recipientName": "Robert Smith",
      "phone": 976356838473,
      "fax": null,
      "mobile": 976356838473,
      "email": "r.smith@mymail.net",
      "url": null
    },
    "curBranchName": "Central office"
  },
  "names": {
    "emboss": "Smith",
    "track": "Smith",
    "print": "Smith"
  },
  "dates": {
    "validFrom": "2019-08-24",
    "creation": "2019-08-24",
    "activation": "2019-08-24",
    "expiration": "2019-08-24",
    "closure": "2019-08-24"
  },
  "notes": "Test card",
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	card
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update card

PUT /tx/v1/card

Creates a new card or updates the existing one

Request body

{
  "object": {
    "ref": {
      "id": 13579,
      "rid": "CRDRID24680"
    },
    "className": "Smart cards",
    "holder": {
      "id": 1746,
      "rid": "PRID73"
    },
    "issuingContractType": {
      "id": 97548,
      "rid": "CTRID975"
    },
    "issuingContract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "financialContract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "mainCard": {
      "id": 13579,
      "rid": "CRDRID24680"
    },
    "product": {
      "id": 22,
      "rid": "CPRID22"
    },
    "design": {
      "id": 12,
      "rid": "DESRID12"
    },
    "panMask": "777777******6543",
    "mbr": 0,
    "status": "string",
    "lifePhaseRid": "LCRID_ATBRANCH",
    "restrictionsProfile": {
      "id": 6846,
      "rid": "RPRID78"
    },
    "tdsEnrollment": true,
    "logistics": {
      "deliveryBranchName": "Branch 1",
      "deliveryAddress": {
        "zip": "NG71AE",
        "country": 0,
        "region": "CAL",
        "regionRid": "string",
        "area": "Nord",
        "areaRid": "string",
        "city": "Homeburg",
        "cityRid": "string",
        "street": "Broadway",
        "streetRid": "string",
        "house": 15,
        "building": 2,
        "construction": 1,
        "flat": 4,
        "addressInCity": null,
        "addressInCountry": null,
        "recipientName": "Robert Smith",
        "phone": 976356838473,
        "fax": null,
        "mobile": 976356838473,
        "email": "r.smith@mymail.net",
        "url": null
      },
      "curBranchName": "Central office"
    },
    "names": {
      "emboss": "Smith",
      "track": "Smith",
      "print": "Smith"
    },
    "dates": {
      "validFrom": "2019-08-24",
      "creation": "2019-08-24",
      "activation": "2019-08-24",
      "expiration": "2019-08-24",
      "closure": "2019-08-24"
    },
    "notes": "Test card",
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
mustExist	query	boolean		Object presence control. Refer to section Idempotency to get more details on the parameter usage.
body	body	object	✔
└─ object	body	card	✔	Card object
‎‎ ‎ └─ ref	body	card-CardRef		References to the card
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card reference ID
‎‎ ‎ └─ className	body	string		Card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
‎‎ ‎ └─ holder	body	subject-SubjectRef		References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ issuingContractType	body	contract-type-ContractTypeRef		References to the contract type
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract type ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract type reference ID
‎‎ ‎ └─ issuingContract	body	contract-ContractRef		References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	body	string		Contract external reference ID
‎‎ ‎ └─ financialContract	body	contract-ContractRef		References to the contract
‎‎ ‎ └─ mainCard	body	card-CardRef		References to the card
‎‎ ‎ └─ product	body	card-product-CardProductRef		References to the card product
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card product ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card product reference ID
‎‎ ‎ └─ design	body	card-design-CardDesignRef		References to the card design
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card design internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card design reference ID
‎‎ ‎ └─ panMask	body	string		Masked PAN
‎‎ ‎ └─ mbr	body	integer		Card member number / EMV application PAN sequence number
‎‎ ‎ └─ status	body	string		Card status
‎‎ ‎ └─ lifePhaseRid	body	string		Card lifecycle phase reference ID. Card lifecycle phases are configured in the system; refer to your TranzAxis configuration to obtain the list of lifecycle phase IDs configured.
‎‎ ‎ └─ restrictionsProfile	body	restriction-RestrictionProfileRef		References to the restriction profile
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Restriction profile reference ID
‎‎ ‎ └─ tdsEnrollment	body	boolean		Indicates that the card is enrolled in E-commerce 3DS service
‎‎ ‎ └─ logistics	body	object		Card delivery details
‎‎ ‎ ‎‎ ‎ └─ deliveryBranchName	body	string		Branch where the card will be delivered to, in case the card needs to be delivered to the branch
‎‎ ‎ ‎‎ ‎ └─ deliveryAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ zip	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	body	integer		ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ region	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ area	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ areaRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ city	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cityRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ street	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ streetRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ house	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ building	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ construction	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ flat	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCity	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCountry	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ recipientName	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phone	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ fax	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mobile	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ email	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ url	body	string
‎‎ ‎ ‎‎ ‎ └─ curBranchName	body	string		Branch where the card is at the moment
‎‎ ‎ └─ names	body	object		Names on the card
‎‎ ‎ ‎‎ ‎ └─ emboss	body	string		Name to be printed/embossed on the card
‎‎ ‎ ‎‎ ‎ └─ track	body	string		Name to be written on Track2 or chip
‎‎ ‎ ‎‎ ‎ └─ print	body	string		Name to be printed on other media, e.g. PIN mailer, etc.
‎‎ ‎ └─ dates	body	object
‎‎ ‎ ‎‎ ‎ └─ validFrom	body	string(date)		Date the card is valid from
‎‎ ‎ ‎‎ ‎ └─ creation	body	string(date)		Date when the card was created
‎‎ ‎ ‎‎ ‎ └─ activation	body	string(date)		Date when the card was activated
‎‎ ‎ ‎‎ ‎ └─ expiration	body	string(date)	✔	Card expiration date in full format. Please convert it to short format as required, e.g. usually the card expiration date is presented to customers as MM/YY.
‎‎ ‎ ‎‎ ‎ └─ closure	body	string(date)		Date when the card was closed
‎‎ ‎ └─ notes	body	string		Comment to the card
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete card

DELETE /tx/v1/card

Deletes the existing card

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETShow card PAN

GET /tx/v1/card/pan

Gets the full card PAN. This endpoint can be used if full PAN is required, e.g. to be displayed to the cardholder in the mobile app. For security reasons, PAN is not fully visible for the Card object returned by the GET /card operation. This endpoint may require PCI DSS compliance. You must comply with the PCI DSS data security requirements if you store, transmit, or process sensitive card data, such as the cardholder primary account number (PAN), personal identification number (PIN), and card expiration date.

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card

Example responses

200 Response

{
  "pan": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ pan	string			PAN value

GETShow card CVV2

GET /tx/v1/card/cvv2

Gets the card CVV2. This endpoint can be used if CVV2 is required, e.g. to be displayed to the cardholder in the mobile app. For security reasons, CVV2 is not visible for the Card object returned by the GET /card operation. This endpoint may require PCI DSS compliance. You must comply with the PCI DSS data security requirements if you store, transmit, or process sensitive card data such as the cardholder primary account number (PAN), personal identification number (PIN), and card expiration date.

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card

Example responses

200 Response

{
  "cvv2": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ cvv2	string			Card CVV2

POSTGet card by PAN

POST /tx/v1/card/pan/list

Lists cards by PAN, and optionally by expiration date. This request is useful in IVR scenarios where the user telephones and identifies the card by PAN. Data is retrieved through a POST request because passing PAN in the request body is more secure than passing it in URL (as would be required with GET).

Request body

{
  "pan": "string",
  "expiration": "2019-08-24"
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ pan	body	string	✔	Card PAN
└─ expiration	body	string(date)		Card expiration date

Example responses

200 Response

{
  "objects": [
    {
      "ref": {
        "id": 13579,
        "rid": "CRDRID24680"
      },
      "className": "Smart cards",
      "holder": {
        "id": 1746,
        "rid": "PRID73"
      },
      "issuingContractType": {
        "id": 97548,
        "rid": "CTRID975"
      },
      "issuingContract": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "financialContract": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "mainCard": {
        "id": 13579,
        "rid": "CRDRID24680"
      },
      "product": {
        "id": 22,
        "rid": "CPRID22"
      },
      "design": {
        "id": 12,
        "rid": "DESRID12"
      },
      "panMask": "777777******6543",
      "mbr": 0,
      "status": "string",
      "lifePhaseRid": "LCRID_ATBRANCH",
      "restrictionsProfile": {
        "id": 6846,
        "rid": "RPRID78"
      },
      "tdsEnrollment": true,
      "logistics": {
        "deliveryBranchName": "Branch 1",
        "deliveryAddress": {
          "zip": "NG71AE",
          "country": 0,
          "region": "CAL",
          "regionRid": "string",
          "area": "Nord",
          "areaRid": "string",
          "city": "Homeburg",
          "cityRid": "string",
          "street": "Broadway",
          "streetRid": "string",
          "house": 15,
          "building": 2,
          "construction": 1,
          "flat": 4,
          "addressInCity": null,
          "addressInCountry": null,
          "recipientName": "Robert Smith",
          "phone": 976356838473,
          "fax": null,
          "mobile": 976356838473,
          "email": "r.smith@mymail.net",
          "url": null
        },
        "curBranchName": "Central office"
      },
      "names": {
        "emboss": "Smith",
        "track": "Smith",
        "print": "Smith"
      },
      "dates": {
        "validFrom": "2019-08-24",
        "creation": "2019-08-24",
        "activation": "2019-08-24",
        "expiration": "2019-08-24",
        "closure": "2019-08-24"
      },
      "notes": "Test card",
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ objects	[card]			Contains the returned cards
‎‎ ‎ └─ Card object	card			Card object
‎‎ ‎ ‎‎ ‎ └─ ref	card-CardRef			References to the card
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Card internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Card reference ID
‎‎ ‎ ‎‎ ‎ └─ className	string			Card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
‎‎ ‎ ‎‎ ‎ └─ holder	subject-SubjectRef			References to the person/company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ issuingContractType	contract-type-ContractTypeRef			References to the contract type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract type ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract type reference ID
‎‎ ‎ ‎‎ ‎ └─ issuingContract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ extRid	string			Contract external reference ID
‎‎ ‎ ‎‎ ‎ └─ financialContract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ └─ mainCard	card-CardRef			References to the card
‎‎ ‎ ‎‎ ‎ └─ product	card-product-CardProductRef			References to the card product
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Card product ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Card product reference ID
‎‎ ‎ ‎‎ ‎ └─ design	card-design-CardDesignRef			References to the card design
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Card design internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Card design reference ID
‎‎ ‎ ‎‎ ‎ └─ panMask	string			Masked PAN
‎‎ ‎ ‎‎ ‎ └─ mbr	integer			Card member number / EMV application PAN sequence number
‎‎ ‎ ‎‎ ‎ └─ status	string			Card status
‎‎ ‎ ‎‎ ‎ └─ lifePhaseRid	string			Card lifecycle phase reference ID. Card lifecycle phases are configured in the system; refer to your TranzAxis configuration to obtain the list of lifecycle phase IDs configured.
‎‎ ‎ ‎‎ ‎ └─ restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Restriction profile reference ID
‎‎ ‎ ‎‎ ‎ └─ tdsEnrollment	boolean			Indicates that the card is enrolled in E-commerce 3DS service
‎‎ ‎ ‎‎ ‎ └─ logistics	object			Card delivery details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ deliveryBranchName	string			Branch where the card will be delivered to, in case the card needs to be delivered to the branch
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ deliveryAddress	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ zip	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	integer			ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ region	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ area	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ areaRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ city	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cityRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ street	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ streetRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ house	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ building	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ construction	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ flat	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCity	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCountry	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ recipientName	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phone	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ fax	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mobile	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ email	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ url	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curBranchName	string			Branch where the card is at the moment
‎‎ ‎ ‎‎ ‎ └─ names	object			Names on the card
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ emboss	string			Name to be printed/embossed on the card
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ track	string			Name to be written on Track2 or chip
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ print	string			Name to be printed on other media, e.g. PIN mailer, etc.
‎‎ ‎ ‎‎ ‎ └─ dates	object
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ validFrom	string(date)			Date the card is valid from
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ creation	string(date)			Date when the card was created
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ activation	string(date)			Date when the card was activated
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ expiration	string(date)	✔		Card expiration date in full format. Please convert it to short format as required, e.g. usually the card expiration date is presented to customers as MM/YY.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ closure	string(date)			Date when the card was closed
‎‎ ‎ ‎‎ ‎ └─ notes	string			Comment to the card
‎‎ ‎ ‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ val	string			Value

GETGet card PIN

GET /tx/v1/card/pin

Gets the card PIN block value. (!) Use this endpoint only to access PIN in order to reveal it to the cardholder. Do not use this endpoint for the purpose of storing PIN at any location. This endpoint may require PCI DSS compliance. You must comply with the PCI DSS data security requirements if you store, transmit, or process sensitive card data, such as the cardholder primary account number (PAN), personal identification number (PIN), and card expiration date.

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card

Example responses

200 Response

{
  "pinBlock": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ pinBlock	string(base64)			Encrypted PIN block. The PIN block format and encryption parameters are defined in the respective RTP interface in TranzAxis.

PUTSet card PIN

PUT /tx/v1/card/pin

Sets the PIN block for the card. This endpoint can be used to create or update the card PIN. Sending a request to this endpoint may require PCI DSS compliance. You must comply with the PCI DSS data security requirements if you want to store, transmit, or process sensitive card data, such as the cardholder primary account number (PAN), personal identification number (PIN), and card expiration date.

Request body

{
  "pinBlock": "string",
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card
body	body	object	✔
└─ pinBlock	body	string(base64)	✔	Encrypted PIN block. The PIN block format and encryption parameters are defined in the respective RTP interface in TranzAxis.
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEReset card counters (e.g. unblock PIN)

DELETE /tx/v1/card/try-counters

This endpoint can be used to reset the security counters of the card, such as PIN attempts, CVV2 attempts, etc.

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card
countersToReset	query	CountersToReset		Counters to reset (if not specified - then reset all)

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTReissue card (replace, renew)

POST /tx/v1/card/reissue

Use this endpoint to create a new card when reissuing the existing card, e.g. if the card is lost, stolen or damaged, or renewing the card (e.g. if the card is expired).

Request body

{
  "copyFromOldCard": {
    "pan": true,
    "pin": true,
    "limits": true,
    "rid": true
  },
  "newCard": {
    "ref": {
      "id": 13579,
      "rid": "CRDRID24680"
    },
    "className": "Smart cards",
    "holder": {
      "id": 1746,
      "rid": "PRID73"
    },
    "issuingContractType": {
      "id": 97548,
      "rid": "CTRID975"
    },
    "issuingContract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "financialContract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "mainCard": {
      "id": 13579,
      "rid": "CRDRID24680"
    },
    "product": {
      "id": 22,
      "rid": "CPRID22"
    },
    "design": {
      "id": 12,
      "rid": "DESRID12"
    },
    "panMask": "777777******6543",
    "mbr": 0,
    "status": "string",
    "lifePhaseRid": "LCRID_ATBRANCH",
    "restrictionsProfile": {
      "id": 6846,
      "rid": "RPRID78"
    },
    "tdsEnrollment": true,
    "logistics": {
      "deliveryBranchName": "Branch 1",
      "deliveryAddress": {
        "zip": "NG71AE",
        "country": 0,
        "region": "CAL",
        "regionRid": "string",
        "area": "Nord",
        "areaRid": "string",
        "city": "Homeburg",
        "cityRid": "string",
        "street": "Broadway",
        "streetRid": "string",
        "house": 15,
        "building": 2,
        "construction": 1,
        "flat": 4,
        "addressInCity": null,
        "addressInCountry": null,
        "recipientName": "Robert Smith",
        "phone": 976356838473,
        "fax": null,
        "mobile": 976356838473,
        "email": "r.smith@mymail.net",
        "url": null
      },
      "curBranchName": "Central office"
    },
    "names": {
      "emboss": "Smith",
      "track": "Smith",
      "print": "Smith"
    },
    "dates": {
      "validFrom": "2019-08-24",
      "creation": "2019-08-24",
      "activation": "2019-08-24",
      "expiration": "2019-08-24",
      "closure": "2019-08-24"
    },
    "notes": "Test card",
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
ref	query	card-CardRef	✔	Unique reference to the card
body	body	object	✔
└─ copyFromOldCard	body	object		Parameters to control the properties to be copied from the card that is being reissued
‎‎ ‎ └─ pan	body	boolean		Keep card PAN. false indicates that the system will generate new PAN for the card. For security reasons, old PAN should not be copied if the card is being replaced due to such reasons as loss, theft, etc.
‎‎ ‎ └─ pin	body	boolean		Keep card PIN
‎‎ ‎ └─ limits	body	boolean		Keep card limits and restrictions
‎‎ ‎ └─ rid	body	boolean		Keep card reference ID
└─ newCard	body	card		Card object
‎‎ ‎ └─ ref	body	card-CardRef		References to the card
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card reference ID
‎‎ ‎ └─ className	body	string		Card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
‎‎ ‎ └─ holder	body	subject-SubjectRef		References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ issuingContractType	body	contract-type-ContractTypeRef		References to the contract type
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract type ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract type reference ID
‎‎ ‎ └─ issuingContract	body	contract-ContractRef		References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	body	string		Contract external reference ID
‎‎ ‎ └─ financialContract	body	contract-ContractRef		References to the contract
‎‎ ‎ └─ mainCard	body	card-CardRef		References to the card
‎‎ ‎ └─ product	body	card-product-CardProductRef		References to the card product
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card product ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card product reference ID
‎‎ ‎ └─ design	body	card-design-CardDesignRef		References to the card design
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card design internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card design reference ID
‎‎ ‎ └─ panMask	body	string		Masked PAN
‎‎ ‎ └─ mbr	body	integer		Card member number / EMV application PAN sequence number
‎‎ ‎ └─ status	body	string		Card status
‎‎ ‎ └─ lifePhaseRid	body	string		Card lifecycle phase reference ID. Card lifecycle phases are configured in the system; refer to your TranzAxis configuration to obtain the list of lifecycle phase IDs configured.
‎‎ ‎ └─ restrictionsProfile	body	restriction-RestrictionProfileRef		References to the restriction profile
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Restriction profile reference ID
‎‎ ‎ └─ tdsEnrollment	body	boolean		Indicates that the card is enrolled in E-commerce 3DS service
‎‎ ‎ └─ logistics	body	object		Card delivery details
‎‎ ‎ ‎‎ ‎ └─ deliveryBranchName	body	string		Branch where the card will be delivered to, in case the card needs to be delivered to the branch
‎‎ ‎ ‎‎ ‎ └─ deliveryAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ zip	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	body	integer		ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ region	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ area	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ areaRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ city	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cityRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ street	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ streetRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ house	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ building	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ construction	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ flat	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCity	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCountry	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ recipientName	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phone	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ fax	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mobile	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ email	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ url	body	string
‎‎ ‎ ‎‎ ‎ └─ curBranchName	body	string		Branch where the card is at the moment
‎‎ ‎ └─ names	body	object		Names on the card
‎‎ ‎ ‎‎ ‎ └─ emboss	body	string		Name to be printed/embossed on the card
‎‎ ‎ ‎‎ ‎ └─ track	body	string		Name to be written on Track2 or chip
‎‎ ‎ ‎‎ ‎ └─ print	body	string		Name to be printed on other media, e.g. PIN mailer, etc.
‎‎ ‎ └─ dates	body	object
‎‎ ‎ ‎‎ ‎ └─ validFrom	body	string(date)		Date the card is valid from
‎‎ ‎ ‎‎ ‎ └─ creation	body	string(date)		Date when the card was created
‎‎ ‎ ‎‎ ‎ └─ activation	body	string(date)		Date when the card was activated
‎‎ ‎ ‎‎ ‎ └─ expiration	body	string(date)	✔	Card expiration date in full format. Please convert it to short format as required, e.g. usually the card expiration date is presented to customers as MM/YY.
‎‎ ‎ ‎‎ ‎ └─ closure	body	string(date)		Date when the card was closed
‎‎ ‎ └─ notes	body	string		Comment to the card
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTAssign prepaid/pre-printed card to the customer

POST /tx/v1/card/preproduced/deliver

Selects the pre-printed card from the batch of cards, assigns it to the customer and sets the card parameters , e.g. status, lifecycle phase, etc. As a rule, such pre-printed cards are not personalized (unnamed) and have limited use.

Request body

{
  "pan": "string",
  "card": {
    "ref": {
      "id": 13579,
      "rid": "CRDRID24680"
    },
    "className": "Smart cards",
    "holder": {
      "id": 1746,
      "rid": "PRID73"
    },
    "issuingContractType": {
      "id": 97548,
      "rid": "CTRID975"
    },
    "issuingContract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "financialContract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "mainCard": {
      "id": 13579,
      "rid": "CRDRID24680"
    },
    "product": {
      "id": 22,
      "rid": "CPRID22"
    },
    "design": {
      "id": 12,
      "rid": "DESRID12"
    },
    "panMask": "777777******6543",
    "mbr": 0,
    "status": "string",
    "lifePhaseRid": "LCRID_ATBRANCH",
    "restrictionsProfile": {
      "id": 6846,
      "rid": "RPRID78"
    },
    "tdsEnrollment": true,
    "logistics": {
      "deliveryBranchName": "Branch 1",
      "deliveryAddress": {
        "zip": "NG71AE",
        "country": 0,
        "region": "CAL",
        "regionRid": "string",
        "area": "Nord",
        "areaRid": "string",
        "city": "Homeburg",
        "cityRid": "string",
        "street": "Broadway",
        "streetRid": "string",
        "house": 15,
        "building": 2,
        "construction": 1,
        "flat": 4,
        "addressInCity": null,
        "addressInCountry": null,
        "recipientName": "Robert Smith",
        "phone": 976356838473,
        "fax": null,
        "mobile": 976356838473,
        "email": "r.smith@mymail.net",
        "url": null
      },
      "curBranchName": "Central office"
    },
    "names": {
      "emboss": "Smith",
      "track": "Smith",
      "print": "Smith"
    },
    "dates": {
      "validFrom": "2019-08-24",
      "creation": "2019-08-24",
      "activation": "2019-08-24",
      "expiration": "2019-08-24",
      "closure": "2019-08-24"
    },
    "notes": "Test card",
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ pan	body	string	✔	Search for the card by PAN and card/dates/expiration
└─ card	body	card		Card object
‎‎ ‎ └─ ref	body	card-CardRef		References to the card
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card reference ID
‎‎ ‎ └─ className	body	string		Card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
‎‎ ‎ └─ holder	body	subject-SubjectRef		References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ issuingContractType	body	contract-type-ContractTypeRef		References to the contract type
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract type ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract type reference ID
‎‎ ‎ └─ issuingContract	body	contract-ContractRef		References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	body	string		Contract external reference ID
‎‎ ‎ └─ financialContract	body	contract-ContractRef		References to the contract
‎‎ ‎ └─ mainCard	body	card-CardRef		References to the card
‎‎ ‎ └─ product	body	card-product-CardProductRef		References to the card product
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card product ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card product reference ID
‎‎ ‎ └─ design	body	card-design-CardDesignRef		References to the card design
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card design internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card design reference ID
‎‎ ‎ └─ panMask	body	string		Masked PAN
‎‎ ‎ └─ mbr	body	integer		Card member number / EMV application PAN sequence number
‎‎ ‎ └─ status	body	string		Card status
‎‎ ‎ └─ lifePhaseRid	body	string		Card lifecycle phase reference ID. Card lifecycle phases are configured in the system; refer to your TranzAxis configuration to obtain the list of lifecycle phase IDs configured.
‎‎ ‎ └─ restrictionsProfile	body	restriction-RestrictionProfileRef		References to the restriction profile
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Restriction profile reference ID
‎‎ ‎ └─ tdsEnrollment	body	boolean		Indicates that the card is enrolled in E-commerce 3DS service
‎‎ ‎ └─ logistics	body	object		Card delivery details
‎‎ ‎ ‎‎ ‎ └─ deliveryBranchName	body	string		Branch where the card will be delivered to, in case the card needs to be delivered to the branch
‎‎ ‎ ‎‎ ‎ └─ deliveryAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ zip	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	body	integer		ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ region	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ area	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ areaRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ city	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cityRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ street	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ streetRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ house	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ building	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ construction	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ flat	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCity	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCountry	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ recipientName	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phone	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ fax	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mobile	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ email	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ url	body	string
‎‎ ‎ ‎‎ ‎ └─ curBranchName	body	string		Branch where the card is at the moment
‎‎ ‎ └─ names	body	object		Names on the card
‎‎ ‎ ‎‎ ‎ └─ emboss	body	string		Name to be printed/embossed on the card
‎‎ ‎ ‎‎ ‎ └─ track	body	string		Name to be written on Track2 or chip
‎‎ ‎ ‎‎ ‎ └─ print	body	string		Name to be printed on other media, e.g. PIN mailer, etc.
‎‎ ‎ └─ dates	body	object
‎‎ ‎ ‎‎ ‎ └─ validFrom	body	string(date)		Date the card is valid from
‎‎ ‎ ‎‎ ‎ └─ creation	body	string(date)		Date when the card was created
‎‎ ‎ ‎‎ ‎ └─ activation	body	string(date)		Date when the card was activated
‎‎ ‎ ‎‎ ‎ └─ expiration	body	string(date)	✔	Card expiration date in full format. Please convert it to short format as required, e.g. usually the card expiration date is presented to customers as MM/YY.
‎‎ ‎ ‎‎ ‎ └─ closure	body	string(date)		Date when the card was closed
‎‎ ‎ └─ notes	body	string		Comment to the card
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList customer cards

GET /tx/v1/cards

Gets the list of cards for the customer. This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
filter	query	CardsFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	CardsOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 13579,
        "rid": "CRDRID24680"
      },
      "className": "Smart cards",
      "holder": {
        "id": 1746,
        "rid": "PRID73"
      },
      "issuingContractType": {
        "id": 97548,
        "rid": "CTRID975"
      },
      "issuingContract": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "financialContract": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "mainCard": {
        "id": 13579,
        "rid": "CRDRID24680"
      },
      "product": {
        "id": 22,
        "rid": "CPRID22"
      },
      "design": {
        "id": 12,
        "rid": "DESRID12"
      },
      "panMask": "777777******6543",
      "mbr": 0,
      "status": "string",
      "lifePhaseRid": "LCRID_ATBRANCH",
      "restrictionsProfile": {
        "id": 6846,
        "rid": "RPRID78"
      },
      "tdsEnrollment": true,
      "logistics": {
        "deliveryBranchName": "Branch 1",
        "deliveryAddress": {
          "zip": "NG71AE",
          "country": 0,
          "region": "CAL",
          "regionRid": "string",
          "area": "Nord",
          "areaRid": "string",
          "city": "Homeburg",
          "cityRid": "string",
          "street": "Broadway",
          "streetRid": "string",
          "house": 15,
          "building": 2,
          "construction": 1,
          "flat": 4,
          "addressInCity": null,
          "addressInCountry": null,
          "recipientName": "Robert Smith",
          "phone": 976356838473,
          "fax": null,
          "mobile": 976356838473,
          "email": "r.smith@mymail.net",
          "url": null
        },
        "curBranchName": "Central office"
      },
      "names": {
        "emboss": "Smith",
        "track": "Smith",
        "print": "Smith"
      },
      "dates": {
        "validFrom": "2019-08-24",
        "creation": "2019-08-24",
        "activation": "2019-08-24",
        "expiration": "2019-08-24",
        "closure": "2019-08-24"
      },
      "notes": "Test card",
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[card]			Contains the returned cards
‎‎ ‎ └─ Card object	card			Card object
‎‎ ‎ ‎‎ ‎ └─ ref	card-CardRef			References to the card
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Card internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Card reference ID
‎‎ ‎ ‎‎ ‎ └─ className	string			Card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
‎‎ ‎ ‎‎ ‎ └─ holder	subject-SubjectRef			References to the person/company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ issuingContractType	contract-type-ContractTypeRef			References to the contract type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract type ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract type reference ID
‎‎ ‎ ‎‎ ‎ └─ issuingContract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ extRid	string			Contract external reference ID
‎‎ ‎ ‎‎ ‎ └─ financialContract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ └─ mainCard	card-CardRef			References to the card
‎‎ ‎ ‎‎ ‎ └─ product	card-product-CardProductRef			References to the card product
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Card product ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Card product reference ID
‎‎ ‎ ‎‎ ‎ └─ design	card-design-CardDesignRef			References to the card design
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Card design internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Card design reference ID
‎‎ ‎ ‎‎ ‎ └─ panMask	string			Masked PAN
‎‎ ‎ ‎‎ ‎ └─ mbr	integer			Card member number / EMV application PAN sequence number
‎‎ ‎ ‎‎ ‎ └─ status	string			Card status
‎‎ ‎ ‎‎ ‎ └─ lifePhaseRid	string			Card lifecycle phase reference ID. Card lifecycle phases are configured in the system; refer to your TranzAxis configuration to obtain the list of lifecycle phase IDs configured.
‎‎ ‎ ‎‎ ‎ └─ restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Restriction profile reference ID
‎‎ ‎ ‎‎ ‎ └─ tdsEnrollment	boolean			Indicates that the card is enrolled in E-commerce 3DS service
‎‎ ‎ ‎‎ ‎ └─ logistics	object			Card delivery details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ deliveryBranchName	string			Branch where the card will be delivered to, in case the card needs to be delivered to the branch
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ deliveryAddress	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ zip	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	integer			ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ region	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ area	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ areaRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ city	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cityRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ street	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ streetRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ house	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ building	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ construction	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ flat	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCity	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCountry	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ recipientName	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phone	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ fax	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mobile	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ email	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ url	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curBranchName	string			Branch where the card is at the moment
‎‎ ‎ ‎‎ ‎ └─ names	object			Names on the card
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ emboss	string			Name to be printed/embossed on the card
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ track	string			Name to be written on Track2 or chip
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ print	string			Name to be printed on other media, e.g. PIN mailer, etc.
‎‎ ‎ ‎‎ ‎ └─ dates	object
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ validFrom	string(date)			Date the card is valid from
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ creation	string(date)			Date when the card was created
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ activation	string(date)			Date when the card was activated
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ expiration	string(date)	✔		Card expiration date in full format. Please convert it to short format as required, e.g. usually the card expiration date is presented to customers as MM/YY.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ closure	string(date)			Date when the card was closed
‎‎ ‎ ‎‎ ‎ └─ notes	string			Comment to the card
‎‎ ‎ ‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ val	string			Value

GETList card designs

GET /tx/v1/card-designs

Lists the card designs available in the system. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 12,
        "rid": "DESRID12"
      },
      "name": "Plain"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal Server Error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[card-design]			Contains the returned card designs
‎‎ ‎ └─ ref	card-design-CardDesignRef			References to the card design
‎‎ ‎ ‎‎ ‎ └─ id	integer			Card design internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Card design reference ID
‎‎ ‎ └─ name	string			Card design name in TranzAxis

GETList card products

GET /tx/v1/card-products

Lists the card products available in the system. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 22,
        "rid": "CPRID22"
      },
      "name": "Unlimited silver",
      "cardClassName": "Smart cards",
      "parentProduct": {
        "id": 22,
        "rid": "CPRID22"
      }
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal Server Error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[card-product]			Contains the returned card products
‎‎ ‎ └─ ref	card-product-CardProductRef			References to the card product
‎‎ ‎ ‎‎ ‎ └─ id	integer			Card product ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Card product reference ID
‎‎ ‎ └─ name	string			Card product name in TranzAxis
‎‎ ‎ └─ cardClassName	string			Name of the card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
‎‎ ‎ └─ parentProduct	card-product-CardProductRef			References to the card product

GETPerform connectivity test (ping)

GET /

Performs connectivity test to check the service availability

Responses

Status	Meaning	Description	Schema
200	OK	OK

GETGet contract

GET /tx/v1/contract

Retrieves the contract details by contract reference. For financial contracts, this endpoint can be used to retrieve the customer account details.

Parameters

Name	In	Type	Required	Description
ref	query	contract-ContractRef	✔	Reference to the contract

Example responses

200 Response

{
  "ref": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "className": "Contract.Shadow",
  "type": {
    "id": 97548,
    "rid": "CTRID975"
  },
  "client": {
    "id": 1746,
    "rid": "PRID73"
  },
  "details": {},
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	contract
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update contract

PUT /tx/v1/contract

Creates a new contract or updates the existing one. For financial contracts, this endpoint can be used to open/update the financial account of the customer.

Request body

{
  "object": {
    "ref": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "className": "Contract.Shadow",
    "type": {
      "id": 97548,
      "rid": "CTRID975"
    },
    "client": {
      "id": 1746,
      "rid": "PRID73"
    },
    "details": {},
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
mustExist	query	boolean		Object presence control. Refer to section Idempotency to get more details on the parameter usage.
body	body	object
└─ object	body	contract		Contract object. Contract in TranzAxis represents common terms and conditions of a product and it is used in the system to power different services, such as card production ("issuing contract"), operations processing ("financial contract"), customer notifications, etc.
‎‎ ‎ └─ ref	body	contract-ContractRef		References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	body	string		Contract external reference ID
‎‎ ‎ └─ className	body	string		Contract class
‎‎ ‎ └─ type	body	contract-type-ContractTypeRef		References to the contract type
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract type ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract type reference ID
‎‎ ‎ └─ client	body	subject-SubjectRef		References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ details	body	any
	body	object		Details specific to the respective contract class
	body	any
	body	contract_details		Common properties of contracts of any class
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ status	body	string		Contract status
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ name	body	string		Contract name
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ dates	body	object
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ creation	body	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ time	body	string(date-time)		System time
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ businessDay	body	string(date)		Business day
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ activation	body	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ finish	body	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ closure	body	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ usageRestriction	body	any		Usage restriction applied to the contract, e.g. due to delinquency state, etc.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ restrictionsProfile	body	restriction-RestrictionProfileRef		References to the restriction profile
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Restriction profile reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ sharedTariffPlan	body	contract-type-TariffPlanRef		Reference to the default (shared) tariff plan
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ guid	body	string		Tariff plan GUID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Tariff plan reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
	body	object		Notification contract details. Notification contract describes how the system notifies customers of transactions, events, etc. The customer should have an active notification subscription, which is part of the notification contract. Subscription has different parameters to control and manage respective notifications.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ subscriptions	body	[object]		List of notification subscriptions
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Subscription ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ type	body	notification-type-NotificationTypeRef		References to the notification type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Notification type ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Notification type reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ status	body	string		Subscription status
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ allowedAddressesIds	body	[integer]		IDs of permitted delivery addresses. null indicates that all addresses are permitted.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ begSendTime	body	integer		System will not send notifications before this time (defined as the number of minutes after 00:00). For example, 420 means that the system will not send notifications before 7 AM (7*60).
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ endSendTime	body	integer		System will not send notifications after this time (defined as the number of minutes after 00:00). For example, 1200 means that the system will not send notifications after 8 PM (20*60).
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ options	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addresses	body	[object]		Notification delivery channel details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Channel ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ isActive	body	boolean		Channel status. true means that the channel is active.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ channelKind	body	string		Channel type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ address	body	string		Notification delivery address, e.g. phone number, email, etc. For push notifications, contains the application address. null means that the customer contact information is used.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ deviceName	body	string		Device name used for push notifications
	body	any
	body	contract_details		Common properties of contracts of any class
	body	object		Merchant service contract details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ settlementContract	body	contract-ContractRef		References to the contract
	body	any
	body	contract_details		Common properties of contracts of any class
	body	object		Merchant settlement contract details
	body	any
	body	contract_details		Common properties of contracts of any class
	body	object		Additional details of the revolving credit contract
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mainCcy	body	string		Contract currency (alpha3 currency code). For multi-currency contracts, it is the main currency of the contract.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclBaseAmt	body	number		Contract credit limit. This is the common base value of the maximum credit amount. Some credit contracts can also have other special credit limits, e.g. for debt categories. Please refer to the configuration of credit contracts in TranzAxis for more detials.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclTmpAmt	body	number		Temporary credit limit. Once set, it is effective during the specified period and replaces the base credit limit.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclTmpPeriodBeg	body	string(date-time)		Temporary credit limit effective from
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclTmpPeriodEnd	body	string(date-time)		Temporary credit limit effective to
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ balances	body	object		Contract balances
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ available	body	number		Available balance (account balance – debit holds/used credit + own funds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ownAvailable	body	number		Available balance of own funds (if applicable). Some credit contracts permit customers to have own funds on the balance.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ledger	body	number		Lenger balance (account balance + credit holds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ financial	body	number		Account balance
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curCreditHolds	body	number		Total amount of credit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curDebitHold	body	number		Total amount of debit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ debt	body	number		Total debt amount
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ creditLimit	body	number		Current credit limit. This balance represents the current effective credit limit value with regard to the active temporary limit and current contract restrictions.
	body	any
	body	contract_details		Common properties of contracts of any class
	body	object		\"Shadow" contract details. "Shadow" contract represents the case with the current account when another system (e.g. Core Banking System) manages the actual account balance while TranzAxis only manages cards and stores common account properties. Usually, such scenario requires an online integration with the account management system to authorize operations and change the balance.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mainCcy	body	string		Contract currency (alpha3 currency code). For multi-currency contracts, it is the main currency of the contract.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ permOverdraft	body	number		Overdraft amount (if permitted)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ tmpOverdraft	body	number		Temporary overdraft amount (if permitted)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ tmpOverdraftExpiration	body	string(date-time)		Temporary overdraft expiration date and time (if permitted)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ balances	body	object		Account balances
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ available	body	number		Available balance (account balance – debit holds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ledger	body	number		Lenger balance (account balance + credit holds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ financial	body	number		Account balance
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curCreditHolds	body	number		Total amount of credit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curDebitHold	body	number		Total amount of debit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ permittedOverdraft	body	number		Available overdraft amount (if applicable)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ debt	body	number		Total debt amount (if applicable)
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete contract

DELETE /tx/v1/contract

Deletes the existing contract

Parameters

Name	In	Type	Required	Description
ref	query	contract-ContractRef	✔	Reference to the contract

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

PUTUpdate balances

PUT /tx/v1/contract/balance

Sets the contract balance. Contracts (accounts) in TranzAxis may have different balances depending on the type of the account/product, e.g. debit card and credit card have different types of balance. Please refer to the current TranzAxis configuration to get more details on how to set the specific balance for the account.

Request body

{
  "balance": 500,
  "lastImpacted": {
    "day": "2019-08-24",
    "tranId": 76535367387
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
ref	query	contract-ContractRef	✔	Reference to the contract
accountRole	query	string	✔	Role of the account to set the balance for. Contracts in TranzAxis may contain several accounts, e.g. to handle different balances/buckets. So it is required to select the specific account (role) to set/update the balance for.
ccy	query	string	✔	Balance currency (alpha3 currency code)
body	body	object
└─ balance	body	number		Balance value
└─ lastImpacted	body	object		Details on the last balance impact
‎‎ ‎ └─ day	body	string(date)		Date of the last impact
‎‎ ‎ └─ tranId	body	integer		Transaction ID of the last impact
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTActivate contract

POST /tx/v1/contract/activate

Activates the contract. Contracts should be activated before they can process business operations.

Request body

{
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
ref	query	contract-ContractRef	✔	Reference to the contract
body	body	object
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTClose contract

POST /tx/v1/contract/close

Closes the contract. Some types of contracts require to be prepared for closure before you can close them.

Request body

{
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
ref	query	contract-ContractRef	✔	Reference to the contract
body	body	object
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTPrepare contract for closure

POST /tx/v1/contract/finish

Finalizes the contract (prepares the contract for closure). Some types of contracts (e.g. credit contracts) require to be prepared for closure first before you can close them.

Request body

{
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
ref	query	contract-ContractRef	✔	Reference to the contract
body	body	object
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTGenerate statement

POST /tx/v1/contract/statement

Generates and returns statement data/document for the contract/account. This endpoint returns the statement details specific to the selected contract type. Statement parameters and configuration are defined in the respective TranzAxis settings. Basically, TranzAxis generates and returns a statement document, e.g. a PDF file with all the details as required by the respective business product (i.e. debit, credit, etc.). Alternatively, the system can generate and return machine-readable data if your front-end system needs to build and present a custom human-readable statement to customers. In this case, the statement type should have user-defined format and the statement data must be generated by the user-defined function instead of the report class. Please check the respective statement type parameters in TranzAxis. (!) Do not confuse this with the "transaction history" which is a different endpoint.

Request body

{
  "statementTypeRid": "STRID456",
  "attachmentTypeId": 10,
  "attachmentTypeRid": "ATTRID45",
  "fromDay": "2019-08-24",
  "toDay": "2019-08-24",
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
ref	query	contract-ContractRef	✔	Reference to the contract
body	body	object
└─ statementTypeRid	body	string		Statement type reference ID
└─ attachmentTypeId	body	integer		Attachment type internal ID
└─ attachmentTypeRid	body	string		Attachment type reference ID.
└─ fromDay	body	string(date)		Statement data period - start date (if applicable)
└─ toDay	body	string(date)		Statement data period - end date (if applicable)
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

"string"

Responses

Status	Meaning	Description	Schema
200	OK	OK	string
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList cards for account

GET /tx/v1/contract/cards

Lists the cards that have access to the financial contract (account). This endpoint supports filtering option.

Parameters

Name	In	Type	Required	Description
contract	query	contract-ContractRef	✔	Reference to the contract
filter	query	object		Filter criteria. Refer to section Filtering to get more details on the parameter usage.

Example responses

200 Response

[
  {
    "linkStatus": "string",
    "cardName": "string",
    "card": {
      "id": 13579,
      "rid": "CRDRID24680"
    }
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Contains the returned cards

Name	Type	Required	Restrictions	Description
└─ linkStatus	string			Card-to-account link status
└─ cardName	string			Card-to-account link name
└─ card	card-CardRef			References to the card
‎‎ ‎ └─ id	integer			Card internal ID
‎‎ ‎ └─ rid	string			Card reference ID

GETList customer contracts (accounts)

GET /tx/v1/contracts

Lists the customer contracts. This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
filter	query	ContractsFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	ContractsOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "className": "Contract.Shadow",
      "type": {
        "id": 97548,
        "rid": "CTRID975"
      },
      "client": {
        "id": 1746,
        "rid": "PRID73"
      },
      "details": {},
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[contract]			Contains the returned contracts
‎‎ ‎ └─ ref	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	string			Contract external reference ID
‎‎ ‎ └─ className	string			Contract class
‎‎ ‎ └─ type	contract-type-ContractTypeRef			References to the contract type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract type ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract type reference ID
‎‎ ‎ └─ client	subject-SubjectRef			References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ └─ details	any

anyOf

Name	Type	Required	Restrictions	Description
	object			Details specific to the respective contract class

or

Name	Type	Required	Restrictions	Description
	any

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ status	string			Contract status
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ name	string			Contract name
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ dates	object
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ creation	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ time	string(date-time)			System time
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ businessDay	string(date)			Business day
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ activation	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ finish	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ closure	contract_details-TimeAndBusinessDay
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ usageRestriction	any			Usage restriction applied to the contract, e.g. due to delinquency state, etc.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Restriction profile reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ sharedTariffPlan	contract-type-TariffPlanRef			Reference to the default (shared) tariff plan
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ guid	string			Tariff plan GUID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Tariff plan reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ val	string			Value

and

Name	Type	Required	Restrictions	Description
	object			Notification contract details. Notification contract describes how the system notifies customers of transactions, events, etc. The customer should have an active notification subscription, which is part of the notification contract. Subscription has different parameters to control and manage respective notifications.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ subscriptions	[object]			List of notification subscriptions
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Subscription ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ type	notification-type-NotificationTypeRef			References to the notification type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Notification type ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Notification type reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ status	string			Subscription status
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ allowedAddressesIds	[integer]			IDs of permitted delivery addresses. null indicates that all addresses are permitted.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ begSendTime	integer			System will not send notifications before this time (defined as the number of minutes after 00:00). For example, 420 means that the system will not send notifications before 7 AM (7*60).
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ endSendTime	integer			System will not send notifications after this time (defined as the number of minutes after 00:00). For example, 1200 means that the system will not send notifications after 8 PM (20*60).
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ options	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addresses	[object]			Notification delivery channel details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Channel ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ isActive	boolean			Channel status. true means that the channel is active.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ channelKind	string			Channel type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ address	string			Notification delivery address, e.g. phone number, email, etc. For push notifications, contains the application address. null means that the customer contact information is used.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ deviceName	string			Device name used for push notifications

or

Name	Type	Required	Restrictions	Description
	any

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			Merchant service contract details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ settlementContract	contract-ContractRef			References to the contract

or

Name	Type	Required	Restrictions	Description
	any

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			Merchant settlement contract details

or

Name	Type	Required	Restrictions	Description
	any

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			Additional details of the revolving credit contract
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mainCcy	string			Contract currency (alpha3 currency code). For multi-currency contracts, it is the main currency of the contract.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclBaseAmt	number			Contract credit limit. This is the common base value of the maximum credit amount. Some credit contracts can also have other special credit limits, e.g. for debt categories. Please refer to the configuration of credit contracts in TranzAxis for more detials.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclTmpAmt	number			Temporary credit limit. Once set, it is effective during the specified period and replaces the base credit limit.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclTmpPeriodBeg	string(date-time)			Temporary credit limit effective from
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cclTmpPeriodEnd	string(date-time)			Temporary credit limit effective to
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ balances	object			Contract balances
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ available	number			Available balance (account balance – debit holds/used credit + own funds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ownAvailable	number			Available balance of own funds (if applicable). Some credit contracts permit customers to have own funds on the balance.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ledger	number			Lenger balance (account balance + credit holds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ financial	number			Account balance
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curCreditHolds	number			Total amount of credit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curDebitHold	number			Total amount of debit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ debt	number			Total debt amount
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ creditLimit	number			Current credit limit. This balance represents the current effective credit limit value with regard to the active temporary limit and current contract restrictions.

or

Name	Type	Required	Restrictions	Description
	any

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			\"Shadow" contract details. "Shadow" contract represents the case with the current account when another system (e.g. Core Banking System) manages the actual account balance while TranzAxis only manages cards and stores common account properties. Usually, such scenario requires an online integration with the account management system to authorize operations and change the balance.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mainCcy	string			Contract currency (alpha3 currency code). For multi-currency contracts, it is the main currency of the contract.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ permOverdraft	number			Overdraft amount (if permitted)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ tmpOverdraft	number			Temporary overdraft amount (if permitted)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ tmpOverdraftExpiration	string(date-time)			Temporary overdraft expiration date and time (if permitted)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ balances	object			Account balances
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ available	number			Available balance (account balance – debit holds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ledger	number			Lenger balance (account balance + credit holds)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ financial	number			Account balance
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curCreditHolds	number			Total amount of credit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ curDebitHold	number			Total amount of debit holds
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ permittedOverdraft	number			Available overdraft amount (if applicable)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ debt	number			Total debt amount (if applicable)

continued

Name	Type	Required	Restrictions	Description
‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes

GETGet contract-to-contract link

GET /tx/v1/contract2contract

Retrieves the contract-to-contract link details

Parameters

Name	In	Type	Required	Description
id	query	integer	✔	Link ID

Example responses

200 Response

{
  "id": 897592,
  "contract1": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "contract1Name": "Digital card",
  "contract2": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "contract2Name": "Revolving",
  "kind": "string",
  "status": "string",
  "seq": 1
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	contract2contract
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update contract-to-contract link

PUT /tx/v1/contract2contract

Creates a new contract-to-contract link or updates the existing one

Request body

{
  "id": 897592,
  "contract1": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "contract1Name": "Digital card",
  "contract2": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "contract2Name": "Revolving",
  "kind": "string",
  "status": "string",
  "seq": 1
}

Parameters

Name	In	Type	Required	Description
mustExist	query	boolean		Object presence control. Refer to section Idempotency to get more details on the parameter usage.
body	body	contract2contract
└─ id	body	integer		Link ID
└─ contract1	body	contract-ContractRef		References to the contract
‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ └─ extRid	body	string		Contract external reference ID
└─ contract1Name	body	string		Name of contract 1
└─ contract2	body	contract-ContractRef		References to the contract
└─ contract2Name	body	string		Name of contract 2
└─ kind	body	string		Link type
└─ status	body	string		Link status
└─ seq	body	integer		Link sequence number in contract 1

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete contract-to-contract link

DELETE /tx/v1/contract2contract

Deletes the existing contract-to-contract link

Parameters

Name	In	Type	Required	Description
id	query	integer	✔	Link ID

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList contract-to-contract links

GET /tx/v1/contract2contracts

Gets the list of contract-to-contract links. This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
filter	query	Contract2ContractsFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	Contract2ContractsOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc
SeqAsc
SeqDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "id": 897592,
      "contract1": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "contract1Name": "Digital card",
      "contract2": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "contract2Name": "Revolving",
      "kind": "string",
      "status": "string",
      "seq": 1
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[contract2contract]			Contains the returned links
‎‎ ‎ └─ id	integer			Link ID
‎‎ ‎ └─ contract1	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	string			Contract external reference ID
‎‎ ‎ └─ contract1Name	string			Name of contract 1
‎‎ ‎ └─ contract2	contract-ContractRef			References to the contract
‎‎ ‎ └─ contract2Name	string			Name of contract 2
‎‎ ‎ └─ kind	string			Link type
‎‎ ‎ └─ status	string			Link status
‎‎ ‎ └─ seq	integer			Link sequence number in contract 1

GETList contract types

GET /tx/v1/contract-types

Gets the list of contract types available in the system. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 97548,
        "rid": "CTRID975"
      },
      "name": "Revolving credit",
      "contractClassName": "Credit contracts",
      "isAbstract": true,
      "parentType": {
        "id": 97548,
        "rid": "CTRID975"
      },
      "tariffPlans": [
        {
          "ref": {
            "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
            "rid": "TPRID963"
          },
          "name": "Common pricing plan"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal Server Error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[contract-type]			Contains the returned contract types
‎‎ ‎ └─ ref	contract-type-ContractTypeRef			References to the contract type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract type ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract type reference ID
‎‎ ‎ └─ name	string			Contract type name
‎‎ ‎ └─ contractClassName	string			Contract class name
‎‎ ‎ └─ isAbstract	boolean			Indicates whether the contract type can be used to create contracts of this type. true indicates that the contract type is abstract and is only used to build a hierarchy of contract types.
‎‎ ‎ └─ parentType	contract-type-ContractTypeRef			References to the contract type
‎‎ ‎ └─ tariffPlans	[contract-type-TariffPlan]			Default pricing parameters (tariff plans) for the business product used by all contracts of this type
‎‎ ‎ ‎‎ ‎ └─ ref	contract-type-TariffPlanRef			Reference to the default (shared) tariff plan
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ guid	string			Tariff plan GUID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Tariff plan reference ID
‎‎ ‎ ‎‎ ‎ └─ name	string			Tariff plan name

POSTPerform user-defined operation 0

POST /tx/v1/custom-operation-0/{function}

Performs custom operation (number 0). Custom (user-defined) operations can be used to implement non-standard business logic or user-defined actions when standard operations and endpoints are not enough. There are several endpoints available (0-9) to implement/call such operations. Such user-defined operations are implemented in TranzAxis as user-defined functions (UDF) and user-defined transactions (UDT). Parameters can be passed in the request body in JSON format. Please also refer to the TranzAxis configuration for more details.

Request body

{
  "param_1": "Value 123"
}

Parameters

Name	In	Type	Required	Description
function	path	string	✔	Unique name for the user-defined function
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 1

POST /tx/v1/custom-operation-1/{function}

Performs custom operation (number 1). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 2

POST /tx/v1/custom-operation-2/{function}

Performs custom operation (number 2). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 3

POST /tx/v1/custom-operation-3/{function}

Performs custom operation (number 3). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 4

POST /tx/v1/custom-operation-4/{function}

Performs custom operation (number 4). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 5

POST /tx/v1/custom-operation-5/{function}

Performs custom operation (number 5). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 6

POST /tx/v1/custom-operation-6/{function}

Performs custom operation (number 6). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 7

POST /tx/v1/custom-operation-7/{function}

Performs custom operation (number 7). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 8

POST /tx/v1/custom-operation-8/{function}

Performs custom operation (number 8). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

POSTPerform user-defined operation 9

POST /tx/v1/custom-operation-9/{function}

Performs custom operation (number 9). Please refer to the custom operation 0 endpoint for more details.

Request body

{}

Parameters

Name	In	Type	Required	Description
function	path	string	✔
body	body	object

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request	Inline
401	Unauthorized	Unauthorized	Inline
403	Forbidden	Forbidden	Inline
404	Not Found	Not found	Inline
422	Unprocessable Entity	Operation declined	Inline
500	Internal Server Error	Internal server error

Response Schema

GETList notification types

GET /tx/v1/notification-types

Lists the notification types configured in the system. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 87648,
        "rid": "NTRID878"
      },
      "name": "OTP",
      "className": "Base Notifications",
      "parentType": {
        "id": 87648,
        "rid": "NTRID878"
      }
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal Server Error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[notification-type]			Contains the returned notification types
‎‎ ‎ └─ ref	notification-type-NotificationTypeRef			References to the notification type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Notification type ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Notification type reference ID
‎‎ ‎ └─ name	string			Notification type name
‎‎ ‎ └─ className	string			Notification type class (=Notification Contract Type)
‎‎ ‎ └─ parentType	notification-type-NotificationTypeRef			References to the notification type

GETGet question-answer pair

GET /tx/v1/subject-auth_qa

Retrieves the details of the question and answer used for customer authentication

Parameters

Name	In	Type	Required	Description
person	query	subject-SubjectRef	✔	Reference to the customer
question	query	string	✔	Question that the answer is required to. The question text is case-sensitive.

Example responses

200 Response

{
  "question": "Name of the first pet",
  "answer": "Rocket"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	subject-auth_qa
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update question-answer pair

PUT /tx/v1/subject-auth_qa

Creates a new question-answer pair or updates the existing one

Request body

{
  "object": {
    "question": "Name of the first pet",
    "answer": "Rocket"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
person	query	subject-SubjectRef	✔	Reference to the customer
body	body	object
└─ object	body	subject-auth_qa		Personal authentication question and answer (security questions)
‎‎ ‎ └─ question	body	string		Personal authentication question
‎‎ ‎ └─ answer	body	string		Personal authentication answer
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete question-answer pair

DELETE /tx/v1/subject-auth_qa

Deletes the existing question-answer pair

Parameters

Name	In	Type	Required	Description
person	query	subject-SubjectRef	✔	Reference to the customer
question	query	string	✔	Question to delete. The question text is case-sensitive.

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList question-answer pairs for the person

GET /tx/v1/subject-auth_qas

Gets the list of authentication question-answer pairs. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
person	query	subject-SubjectRef	✔	Reference to the customer
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "question": "Name of the first pet",
      "answer": "Rocket"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[subject-auth_qa]			Contains the returned question-answer pairs
‎‎ ‎ └─ question	string			Personal authentication question
‎‎ ‎ └─ answer	string			Personal authentication answer

GETGet restriction

GET /tx/v1/restriction

Retrieves the restriction details by reference

Parameters

Name	In	Type	Required	Description
ref	query	restriction-RestrictionRef	✔	Reference to the restriction
owner	query	restriction-OwnerRef	✔	Reference to the restriction owner

Example responses

200 Response

{
  "ref": {
    "guid": "7febf16f651b43b0a5e30da8da49e",
    "rid": "RRID0847"
  },
  "classGuid": "7febf16f651b43b0a5e30da8da49e90d",
  "name": "Daily usage limit",
  "inUse": true,
  "begTime": "2020-10-21T14:15:00",
  "endTime": "2020-10-22T14:15:00",
  "tmpOff": {
    "begTime": "2020-11-21T14:15:00",
    "endTime": "2020-11-22T14:15:00"
  },
  "maxVal": 10,
  "ccy": "USD",
  "tmpMax": {
    "val": 20,
    "begTime": "2020-10-21T14:15:00",
    "endTime": "2020-10-22T14:15:00"
  },
  "limit": {
    "reset": {
      "periodType": "string",
      "timeOffset": 1440
    },
    "windowSize": 30,
    "curVal": 3,
    "lastResetTime": "2020-10-21T14:15:00"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	restriction
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update restriction

PUT /tx/v1/restriction

Creates a new restriction or updates the existing one for the object. To reset the limit, set the current value to "0" (limit.curVal).

Request body

{
  "object": {
    "ref": {
      "guid": "7febf16f651b43b0a5e30da8da49e",
      "rid": "RRID0847"
    },
    "classGuid": "7febf16f651b43b0a5e30da8da49e90d",
    "name": "Daily usage limit",
    "inUse": true,
    "begTime": "2020-10-21T14:15:00",
    "endTime": "2020-10-22T14:15:00",
    "tmpOff": {
      "begTime": "2020-11-21T14:15:00",
      "endTime": "2020-11-22T14:15:00"
    },
    "maxVal": 10,
    "ccy": "USD",
    "tmpMax": {
      "val": 20,
      "begTime": "2020-10-21T14:15:00",
      "endTime": "2020-10-22T14:15:00"
    },
    "limit": {
      "reset": {
        "periodType": "string",
        "timeOffset": 1440
      },
      "windowSize": 30,
      "curVal": 3,
      "lastResetTime": "2020-10-21T14:15:00"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
owner	query	restriction-OwnerRef	✔	Reference to the restriction owner. To modify the restriction, use the ref parameters of the restriction object in the request body.
body	body	object
└─ object	body	restriction		Restriction object. Restriction object in TranzAxis represents different limits, counters and other restrictions that can be applied to cards (tokens), accounts (contracts), customers (subjects) and terminals to control operations, e.g. velocity limits, permitted transaction types, etc. Restrictions are combined into restriction/risk profiles that comprise limitations of the same category, e.g. "contract restriction profile" is applied to contracts, "card/token risk profile" is applied to cards, etc.
‎‎ ‎ └─ ref	body	restriction-RestrictionRef		References to the restriction/limit
‎‎ ‎ ‎‎ ‎ └─ guid	body	string		Restriction internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Restriction reference ID
‎‎ ‎ └─ classGuid	body	string		Unique restriction class identifier
‎‎ ‎ └─ name	body	string		Restriction name (description)
‎‎ ‎ └─ inUse	body	boolean		Indicates that the restriction is active. true indicates that the restriction is currently in use.
‎‎ ‎ └─ begTime	body	string(date-time)		Restriction effective from
‎‎ ‎ └─ endTime	body	string(date-time)		Restriction effective to
‎‎ ‎ └─ tmpOff	body	object		Indicates that the restriction is temporarily disabled (during the usage period)
‎‎ ‎ ‎‎ ‎ └─ begTime	body	string(date-time)		Restriction inactive from
‎‎ ‎ ‎‎ ‎ └─ endTime	body	string(date-time)		Restriction inactive to
‎‎ ‎ └─ maxVal	body	number		Maximum restriction value. For restrictions of the "limit" type, it is the maximum accumulated value; for other types of restrictions, it is the maximum value of the transaction.
‎‎ ‎ └─ ccy	body	string		Restriction currency (alpha3 currency code)
‎‎ ‎ └─ tmpMax	body	object		Parameters of the temporary maximum value
‎‎ ‎ ‎‎ ‎ └─ val	body	number		Temporary maximum value
‎‎ ‎ ‎‎ ‎ └─ begTime	body	string(date-time)		Temporary maximum value effective from
‎‎ ‎ ‎‎ ‎ └─ endTime	body	string(date-time)		Temporary maximum value effective to
‎‎ ‎ └─ limit	body	object		Limit parameters (applicable to restrictions of the "limit" type)
‎‎ ‎ ‎‎ ‎ └─ reset	body	object		Limit reset parameters
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ periodType	body	string		Limit reset period
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ timeOffset	body	integer		Reset time offset. Defined as the number of minutes after the period start.
‎‎ ‎ ‎‎ ‎ └─ windowSize	body	integer		Accumulation window. Defines how many periods will be used during accumulation.
‎‎ ‎ ‎‎ ‎ └─ curVal	body	number		Currently accumulated value
‎‎ ‎ ‎‎ ‎ └─ lastResetTime	body	string(date-time)		Date/time when the limit was last reset
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete restriction

DELETE /tx/v1/restriction

Deletes the existing restriction for the object

Parameters

Name	In	Type	Required	Description
ref	query	restriction-RestrictionRef	✔	Reference to the restriction
owner	query	restriction-OwnerRef	✔	Reference to the restriction owner

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList restrictions

GET /tx/v1/restrictions

Gets the list of restrictions for the object (owner). This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
owner	query	restriction-OwnerRef	✔	Reference to the restriction owner
onlyOwn	query	boolean		Indicates that the list should contain the owner restrictions only. true indicates that only restrictions of the selected object will be returned, otherwise, the full set of assigned restrictions will be returned (both of the selected object and those inherited from the product).
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "guid": "7febf16f651b43b0a5e30da8da49e",
        "rid": "RRID0847"
      },
      "classGuid": "7febf16f651b43b0a5e30da8da49e90d",
      "name": "Daily usage limit",
      "inUse": true,
      "begTime": "2020-10-21T14:15:00",
      "endTime": "2020-10-22T14:15:00",
      "tmpOff": {
        "begTime": "2020-11-21T14:15:00",
        "endTime": "2020-11-22T14:15:00"
      },
      "maxVal": 10,
      "ccy": "USD",
      "tmpMax": {
        "val": 20,
        "begTime": "2020-10-21T14:15:00",
        "endTime": "2020-10-22T14:15:00"
      },
      "limit": {
        "reset": {
          "periodType": "string",
          "timeOffset": 1440
        },
        "windowSize": 30,
        "curVal": 3,
        "lastResetTime": "2020-10-21T14:15:00"
      },
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[restriction]			Contains the returned restrictions
‎‎ ‎ └─ ref	restriction-RestrictionRef			References to the restriction/limit
‎‎ ‎ ‎‎ ‎ └─ guid	string			Restriction internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Restriction reference ID
‎‎ ‎ └─ classGuid	string			Unique restriction class identifier
‎‎ ‎ └─ name	string			Restriction name (description)
‎‎ ‎ └─ inUse	boolean			Indicates that the restriction is active. true indicates that the restriction is currently in use.
‎‎ ‎ └─ begTime	string(date-time)			Restriction effective from
‎‎ ‎ └─ endTime	string(date-time)			Restriction effective to
‎‎ ‎ └─ tmpOff	object			Indicates that the restriction is temporarily disabled (during the usage period)
‎‎ ‎ ‎‎ ‎ └─ begTime	string(date-time)			Restriction inactive from
‎‎ ‎ ‎‎ ‎ └─ endTime	string(date-time)			Restriction inactive to
‎‎ ‎ └─ maxVal	number			Maximum restriction value. For restrictions of the "limit" type, it is the maximum accumulated value; for other types of restrictions, it is the maximum value of the transaction.
‎‎ ‎ └─ ccy	string			Restriction currency (alpha3 currency code)
‎‎ ‎ └─ tmpMax	object			Parameters of the temporary maximum value
‎‎ ‎ ‎‎ ‎ └─ val	number			Temporary maximum value
‎‎ ‎ ‎‎ ‎ └─ begTime	string(date-time)			Temporary maximum value effective from
‎‎ ‎ ‎‎ ‎ └─ endTime	string(date-time)			Temporary maximum value effective to
‎‎ ‎ └─ limit	object			Limit parameters (applicable to restrictions of the "limit" type)
‎‎ ‎ ‎‎ ‎ └─ reset	object			Limit reset parameters
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ periodType	string			Limit reset period
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ timeOffset	integer			Reset time offset. Defined as the number of minutes after the period start.
‎‎ ‎ ‎‎ ‎ └─ windowSize	integer			Accumulation window. Defines how many periods will be used during accumulation.
‎‎ ‎ ‎‎ ‎ └─ curVal	number			Currently accumulated value
‎‎ ‎ ‎‎ ‎ └─ lastResetTime	string(date-time)			Date/time when the limit was last reset
‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	string			Value

GETGet person or company

GET /tx/v1/subject

Retrieves the subject details by reference

Parameters

Name	In	Type	Required	Description
ref	query	subject-SubjectRef	✔	Reference to the person or company

Example responses

200 Response

{
  "ref": {
    "id": 1746,
    "rid": "PRID73"
  },
  "type": {
    "id": 564,
    "rid": "STRID23"
  },
  "kind": "Person",
  "details": {},
  "networkSpec": [
    {
      "networkName": "string",
      "toDelete": true,
      "rid": "string",
      "merchantRid": "string",
      "singleMerchantRid": "string",
      "name": "string",
      "mcc": "string"
    }
  ],
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	subject
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update person or company

PUT /tx/v1/subject

Creates a new person or company or updates the existing one

Request body

{
  "object": {
    "ref": {
      "id": 1746,
      "rid": "PRID73"
    },
    "type": {
      "id": 564,
      "rid": "STRID23"
    },
    "kind": "Person",
    "details": {},
    "networkSpec": [
      {
        "networkName": "string",
        "toDelete": true,
        "rid": "string",
        "merchantRid": "string",
        "singleMerchantRid": "string",
        "name": "string",
        "mcc": "string"
      }
    ],
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
mustExist	query	boolean		Object presence control. Refer to section Idempotency to get more details on the parameter usage.
body	body	object
└─ object	body	subject		Subject (person, company)
‎‎ ‎ └─ ref	body	subject-SubjectRef		References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ type	body	subject-type-SubjectTypeRef		Reference to the subject type
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Subject type ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Subject type reference ID
‎‎ ‎ └─ kind	body	subject-SubjectKind		Subject type
‎‎ ‎ └─ details	body	any
	body	object		Details specific to the respective subject class
	body	any
	body	subject_details		Common properties of subjects of any type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mailAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ zip	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	body	integer		ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ region	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ area	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ areaRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ city	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cityRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ street	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ streetRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ house	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ building	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ construction	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ flat	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCity	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCountry	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ recipientName	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phone	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ fax	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mobile	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ email	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ url	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ languageCode	body	string		Contact language (ISO alpha-2 language code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ locale	body	string		Communication locale (IETF language tag)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ status	body	string		Person/company status in TranzAxis
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ notificationContractId	body	integer		If the person/company has active notification subscriptions - internal ID of the currently active notification contract (also refer to the "contract" object for more details)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ documents	body	[subject-document]		Subject document container
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ref	body	subject-document-SubjectDocumentRef		Reference to the document
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Document internal ID. (!) Please note that this is not a document number.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ type	body	subject-document-type-SubjectDocumentTypeRef		Reference to the document type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Document type ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Document type reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ series	body	string		Document series or prefix. For example, some passports can contain two parts in its number – the series and the number itself, e.g. "7500 123456" as the full passport number.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	body	integer		ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Document number (reference ID)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issuerName	body	string		Entity that issued the document
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issuerId	body	integer		Issuer identifier
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issuerRid	body	string		Issuer reference identifier
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ isActive	body	boolean		Indicates that the document is active. true indicates that the document is active in TranzAxis.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issueDate	body	string(date)		Date when the document was issued
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ expDate	body	string(date)		Document expiration date
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
	body	object		Company or corporate customer details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ parent	body	subject-SubjectRef		References to the person/company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ name	body	string		Full name of the company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ shortName	body	string		Short name of the company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ legalName	body	string		Legal name of the company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ latName	body	string		Company name in latin
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ address	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ legalAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mailAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mcc	body	integer		Merchant category code
	body	any
	body	subject_details		Common properties of subjects of any type
	body	object		Person or individual customer details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ lastName	body	string		Last name
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ firstName	body	string		First name
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ middleName	body	string		Middle name (if applicable)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ birthDate	body	string(date)		Birthdate
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ gender	body	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ residenceCountry	body	integer		Country of residence (ISO numeric code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ citizenshipCountry	body	integer		Country of citizenship, main (ISO numeric code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ extraCitizenships	body	[integer]		Countries of citizenship, others (ISO numeric code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ homeAddress	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ emails	body	[string]		List of emails
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phones	body	[string]		List of contact phone numbers
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ workPhones	body	[string]		List of office phone numbers
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ restrictionsProfile	body	restriction-RestrictionProfileRef		References to the restriction profile
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Restriction profile reference ID
‎‎ ‎ └─ networkSpec	body	[subject-NetworkSpecAttr]		List of network-specific attributes
‎‎ ‎ ‎‎ ‎ └─ networkName	body	string		Network name
‎‎ ‎ ‎‎ ‎ └─ toDelete	body	boolean		Delete this attribute
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ merchantRid	body	string		Merchant reference ID
‎‎ ‎ ‎‎ ‎ └─ singleMerchantRid	body	string		Single merchant reference ID
‎‎ ‎ ‎‎ ‎ └─ name	body	string		Name
‎‎ ‎ ‎‎ ‎ └─ mcc	body	string		MCC
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete person or company

DELETE /tx/v1/subject

Deletes the existing person or company

Parameters

Name	In	Type	Required	Description
ref	query	subject-SubjectRef	✔	Reference to the person or company

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTSend notification to customer

POST /tx/v1/subject/notification

Sends notifications to the customer via the selected channel, e.g. SMS, email, push

Request body

{
  "channelKind": "string",
  "address": "one21@mail.net",
  "messageSubject": "Information",
  "messageBody": "Welcome to the club!"
}

Parameters

Name	In	Type	Required	Description
subject	query	subject-SubjectRef		Reference to the customer (if available)
body	body	object
└─ channelKind	body	string		Delivery channel type
└─ address	body	string		Mobile phone number, email address, etc.
└─ messageSubject	body	string		Message subject
└─ messageBody	body	string		Message body

Responses

Status	Meaning	Description	Schema
200	OK	OK
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

GETList subjects

GET /tx/v1/subjects

Gets the list of persons or companies. This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
filter	query	SubjectsFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	SubjectsOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc
RidAsc
RidDesc
NameAsc
NameDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 1746,
        "rid": "PRID73"
      },
      "type": {
        "id": 564,
        "rid": "STRID23"
      },
      "kind": "Person",
      "details": {},
      "networkSpec": [
        {
          "networkName": "string",
          "toDelete": true,
          "rid": "string",
          "merchantRid": "string",
          "singleMerchantRid": "string",
          "name": "string",
          "mcc": "string"
        }
      ],
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more unreturned objects exist.
└─ objects	[subject]			Contains the returned subjects
‎‎ ‎ └─ ref	subject-SubjectRef			References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ └─ type	subject-type-SubjectTypeRef			Reference to the subject type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Subject type ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Subject type reference ID
‎‎ ‎ └─ kind	subject-SubjectKind			Subject type
‎‎ ‎ └─ details	any

anyOf

Name	Type	Required	Restrictions	Description
	object			Details specific to the respective subject class

or

Name	Type	Required	Restrictions	Description
	any

allOf

Name	Type	Required	Restrictions	Description
	subject_details			Common properties of subjects of any type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mailAddress	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ zip	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	integer			ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ region	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ area	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ areaRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ city	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ cityRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ street	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ streetRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ house	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ building	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ construction	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ flat	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCity	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ addressInCountry	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ recipientName	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phone	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ fax	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mobile	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ email	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ url	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ languageCode	string			Contact language (ISO alpha-2 language code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ locale	string			Communication locale (IETF language tag)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ status	string			Person/company status in TranzAxis
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ notificationContractId	integer			If the person/company has active notification subscriptions - internal ID of the currently active notification contract (also refer to the "contract" object for more details)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ documents	[subject-document]			Subject document container
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ref	subject-document-SubjectDocumentRef			Reference to the document
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Document internal ID. (!) Please note that this is not a document number.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ type	subject-document-type-SubjectDocumentTypeRef			Reference to the document type
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Document type ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Document type reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ series	string			Document series or prefix. For example, some passports can contain two parts in its number – the series and the number itself, e.g. "7500 123456" as the full passport number.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ country	integer			ISO numeric code
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regionRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Document number (reference ID)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issuerName	string			Entity that issued the document
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issuerId	integer			Issuer identifier
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issuerRid	string			Issuer reference identifier
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ isActive	boolean			Indicates that the document is active. true indicates that the document is active in TranzAxis.
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ issueDate	string(date)			Date when the document was issued
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ expDate	string(date)			Document expiration date
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ val	string			Value
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes

and

Name	Type	Required	Restrictions	Description
	object			Company or corporate customer details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ parent	subject-SubjectRef			References to the person/company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ name	string			Full name of the company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ shortName	string			Short name of the company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ legalName	string			Legal name of the company
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ latName	string			Company name in latin
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ address	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ legalAddress	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mailAddress	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mcc	integer			Merchant category code

or

Name	Type	Required	Restrictions	Description
	any

allOf

Name	Type	Required	Restrictions	Description
	subject_details			Common properties of subjects of any type

and

Name	Type	Required	Restrictions	Description
	object			Person or individual customer details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ lastName	string			Last name
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ firstName	string			First name
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ middleName	string			Middle name (if applicable)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ birthDate	string(date)			Birthdate
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ gender	string
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ residenceCountry	integer			Country of residence (ISO numeric code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ citizenshipCountry	integer			Country of citizenship, main (ISO numeric code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ extraCitizenships	[integer]			Countries of citizenship, others (ISO numeric code)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ regAddress	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ homeAddress	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ emails	[string]			List of emails
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ phones	[string]			List of contact phone numbers
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ workPhones	[string]			List of office phone numbers
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Restriction profile reference ID

continued

Name	Type	Required	Restrictions	Description
‎‎ ‎ └─ networkSpec	[subject-NetworkSpecAttr]			List of network-specific attributes
‎‎ ‎ ‎‎ ‎ └─ networkName	string			Network name
‎‎ ‎ ‎‎ ‎ └─ toDelete	boolean			Delete this attribute
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ merchantRid	string			Merchant reference ID
‎‎ ‎ ‎‎ ‎ └─ singleMerchantRid	string			Single merchant reference ID
‎‎ ‎ ‎‎ ‎ └─ name	string			Name
‎‎ ‎ ‎‎ ‎ └─ mcc	string			MCC
‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes

kind ─ Enumerated Value

Value
Person
Corporation

GETGet document

GET /tx/v1/subject-document

Retrieves the subject document details

Parameters

Name	In	Type	Required	Description
ref	query	subject-document-SubjectDocumentRef	✔	Reference to the document

Example responses

200 Response

{
  "ref": {
    "id": 8737
  },
  "type": {
    "id": 56,
    "rid": "DTRID084"
  },
  "series": 7522,
  "country": 0,
  "regionRid": "string",
  "rid": 888122,
  "issuerName": "Regional security office",
  "issuerId": 2,
  "issuerRid": "Rid",
  "isActive": true,
  "issueDate": "2020-10-21",
  "expDate": "2035-10-21",
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	subject-document
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update document

PUT /tx/v1/subject-document

Creates a new document or updates the existing one for the subject (person or company)

Request body

{
  "object": {
    "ref": {
      "id": 8737
    },
    "type": {
      "id": 56,
      "rid": "DTRID084"
    },
    "series": 7522,
    "country": 0,
    "regionRid": "string",
    "rid": 888122,
    "issuerName": "Regional security office",
    "issuerId": 2,
    "issuerRid": "Rid",
    "isActive": true,
    "issueDate": "2020-10-21",
    "expDate": "2035-10-21",
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
subject	query	subject-SubjectRef	✔	Reference to the subject (person or company)
mustExist	query	boolean		Object presence control. Refer to section Idempotency to get more details on the parameter usage.
body	body	object
└─ object	body	subject-document		Document object (passport, national ID, etc.)
‎‎ ‎ └─ ref	body	subject-document-SubjectDocumentRef		Reference to the document
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Document internal ID. (!) Please note that this is not a document number.
‎‎ ‎ └─ type	body	subject-document-type-SubjectDocumentTypeRef		Reference to the document type
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Document type ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Document type reference ID
‎‎ ‎ └─ series	body	string		Document series or prefix. For example, some passports can contain two parts in its number – the series and the number itself, e.g. "7500 123456" as the full passport number.
‎‎ ‎ └─ country	body	integer		ISO numeric code
‎‎ ‎ └─ regionRid	body	string		RID in the address database
‎‎ ‎ └─ rid	body	string		Document number (reference ID)
‎‎ ‎ └─ issuerName	body	string		Entity that issued the document
‎‎ ‎ └─ issuerId	body	integer		Issuer identifier
‎‎ ‎ └─ issuerRid	body	string		Issuer reference identifier
‎‎ ‎ └─ isActive	body	boolean		Indicates that the document is active. true indicates that the document is active in TranzAxis.
‎‎ ‎ └─ issueDate	body	string(date)		Date when the document was issued
‎‎ ‎ └─ expDate	body	string(date)		Document expiration date
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete document

DELETE /tx/v1/subject-document

Deletes the subject document

Parameters

Name	In	Type	Required	Description
ref	query	subject-document-SubjectDocumentRef	✔	Reference to the document

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList documents

GET /tx/v1/subject-documents

Gets the list of documents for a person or company. This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
filter	query	SubjectDocumentsFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	SubjectDocumentsOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 8737
      },
      "type": {
        "id": 56,
        "rid": "DTRID084"
      },
      "series": 7522,
      "country": 0,
      "regionRid": "string",
      "rid": 888122,
      "issuerName": "Regional security office",
      "issuerId": 2,
      "issuerRid": "Rid",
      "isActive": true,
      "issueDate": "2020-10-21",
      "expDate": "2035-10-21",
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal Server Error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. ``true``` indicates that more objects to return exist.
└─ objects	[subject-document]			Contains the returned documents
‎‎ ‎ └─ ref	subject-document-SubjectDocumentRef			Reference to the document
‎‎ ‎ ‎‎ ‎ └─ id	integer			Document internal ID. (!) Please note that this is not a document number.
‎‎ ‎ └─ type	subject-document-type-SubjectDocumentTypeRef			Reference to the document type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Document type ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Document type reference ID
‎‎ ‎ └─ series	string			Document series or prefix. For example, some passports can contain two parts in its number – the series and the number itself, e.g. "7500 123456" as the full passport number.
‎‎ ‎ └─ country	integer			ISO numeric code
‎‎ ‎ └─ regionRid	string			RID in the address database
‎‎ ‎ └─ rid	string			Document number (reference ID)
‎‎ ‎ └─ issuerName	string			Entity that issued the document
‎‎ ‎ └─ issuerId	integer			Issuer identifier
‎‎ ‎ └─ issuerRid	string			Issuer reference identifier
‎‎ ‎ └─ isActive	boolean			Indicates that the document is active. true indicates that the document is active in TranzAxis.
‎‎ ‎ └─ issueDate	string(date)			Date when the document was issued
‎‎ ‎ └─ expDate	string(date)			Document expiration date
‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	string			Value

GETList subject types

GET /tx/v1/subject-types

Gets the list of subject types available in the system. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 564,
        "rid": "STRID23"
      },
      "name": "Customer",
      "kind": "Person",
      "parentType": {
        "id": 564,
        "rid": "STRID23"
      }
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[subject-type]			Contains the returned subject types
‎‎ ‎ └─ ref	subject-type-SubjectTypeRef			Reference to the subject type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Subject type ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Subject type reference ID
‎‎ ‎ └─ name	string			Subject type name
‎‎ ‎ └─ kind	subject-SubjectKind			Subject type
‎‎ ‎ └─ parentType	subject-type-SubjectTypeRef			Reference to the subject type

kind ─ Enumerated Value

Value
Person
Corporation

GETList surcharge tariff plans

GET /tx/v1/surcharge-tariff-plans

Gets the list of available surcharge tariff plans. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": "BHUMNF5OOJEH7AWVPAHS2OY6XYXX",
        "rid": "TP23"
      },
      "name": "Common"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[surcharge-tariff-plan]			Contains the returned objects
‎‎ ‎ └─ ref	surcharge-tariff-plan-SurchargeTariffPlanRef			Reference to the surcharge tariff plan
‎‎ ‎ ‎‎ ‎ └─ id	string			Tariff plan ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Tariff plan reference ID
‎‎ ‎ └─ name	string			Tariff plan name

GETGet terminal

GET /tx/v1/terminal

Retrieves the terminal details by reference

Parameters

Name	In	Type	Required	Description
ref	query	terminal-TerminalRef	✔	Reference to the terminal

Example responses

200 Response

{
  "ref": {
    "id": 1746,
    "rid": "T73",
    "extRid": "ET73"
  },
  "name": "string",
  "title": "string",
  "className": "string",
  "type": "string",
  "status": "string",
  "branch": {
    "id": 1746,
    "rid": "B3",
    "code": "BB2"
  },
  "merchantServiceContract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "settings": {
    "id": 564,
    "rid": "POS23"
  },
  "config": {
    "id": 564,
    "rid": "Ab23"
  },
  "cashAccountingSchemeRid": {
    "id": 1746,
    "rid": "ET73"
  },
  "surchargeTariffPlan": {
    "id": "BHUMNF5OOJEH7AWVPAHS2OY6XYXX",
    "rid": "TP23"
  },
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "mcc": 5942,
  "defaultCurrency": "USD",
  "defaultLanguage": "string",
  "timeZone": "UTC",
  "address": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "keys": {
    "pmk": {
      "id": 1746
    },
    "pwk": {
      "id": 1746
    },
    "mmk": {
      "id": 1746
    },
    "mwk": {
      "id": 1746
    },
    "emk": {
      "id": 1746
    },
    "ewk": {
      "id": 1746
    },
    "rkl": {
      "id": 1746
    }
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	terminal
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update terminal

PUT /tx/v1/terminal

Creates a new terminal or updates the existing one

Request body

{
  "object": {
    "ref": {
      "id": 1746,
      "rid": "T73",
      "extRid": "ET73"
    },
    "name": "string",
    "title": "string",
    "className": "string",
    "type": "string",
    "status": "string",
    "branch": {
      "id": 1746,
      "rid": "B3",
      "code": "BB2"
    },
    "merchantServiceContract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "settings": {
      "id": 564,
      "rid": "POS23"
    },
    "config": {
      "id": 564,
      "rid": "Ab23"
    },
    "cashAccountingSchemeRid": {
      "id": 1746,
      "rid": "ET73"
    },
    "surchargeTariffPlan": {
      "id": "BHUMNF5OOJEH7AWVPAHS2OY6XYXX",
      "rid": "TP23"
    },
    "restrictionsProfile": {
      "id": 6846,
      "rid": "RPRID78"
    },
    "mcc": 5942,
    "defaultCurrency": "USD",
    "defaultLanguage": "string",
    "timeZone": "UTC",
    "address": {
      "zip": "NG71AE",
      "country": 0,
      "region": "CAL",
      "regionRid": "string",
      "area": "Nord",
      "areaRid": "string",
      "city": "Homeburg",
      "cityRid": "string",
      "street": "Broadway",
      "streetRid": "string",
      "house": 15,
      "building": 2,
      "construction": 1,
      "flat": 4,
      "addressInCity": null,
      "addressInCountry": null,
      "recipientName": "Robert Smith",
      "phone": 976356838473,
      "fax": null,
      "mobile": 976356838473,
      "email": "r.smith@mymail.net",
      "url": null
    },
    "keys": {
      "pmk": {
        "id": 1746
      },
      "pwk": {
        "id": 1746
      },
      "mmk": {
        "id": 1746
      },
      "mwk": {
        "id": 1746
      },
      "emk": {
        "id": 1746
      },
      "ewk": {
        "id": 1746
      },
      "rkl": {
        "id": 1746
      }
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
mustExist	query	boolean		Object presence control. Refer to section Idempotency to get more details on the parameter usage.
body	body	object
└─ object	body	terminal		Terminal
‎‎ ‎ └─ ref	body	terminal-TerminalRef		References to the terminal
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	body	string		External reference ID
‎‎ ‎ └─ name	body	string		TID
‎‎ ‎ └─ title	body	string
‎‎ ‎ └─ className	body	string		classGuid
‎‎ ‎ └─ type	body	string
‎‎ ‎ └─ status	body	string
‎‎ ‎ └─ branch	body	common-BranchRef		Reference to the branch
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ code	body	string		Code
‎‎ ‎ └─ merchantServiceContract	body	contract-ContractRef		References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	body	string		Contract external reference ID
‎‎ ‎ └─ settings	body	terminal-settings-TerminalSettingsRef		Reference to the terminal settings
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Terminal settings ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Terminal settings reference ID
‎‎ ‎ └─ config	body	terminal-config-TermConfigRef		Reference to the terminal configuration
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Terminal configuration ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Terminal configuration reference ID
‎‎ ‎ └─ cashAccountingSchemeRid	body	terminal-CashAccountingSchemeRef		Reference to the cash accounting scheme (cash profile)
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ surchargeTariffPlan	body	surcharge-tariff-plan-SurchargeTariffPlanRef		Reference to the surcharge tariff plan
‎‎ ‎ ‎‎ ‎ └─ id	body	string		Tariff plan ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Tariff plan reference ID
‎‎ ‎ └─ restrictionsProfile	body	restriction-RestrictionProfileRef		References to the restriction profile
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Restriction profile reference ID
‎‎ ‎ └─ mcc	body	integer		Merchant category code
‎‎ ‎ └─ defaultCurrency	body	string		Default terminal currency (alpha3 code)
‎‎ ‎ └─ defaultLanguage	body	string		Default terminal language (alpha2 code)
‎‎ ‎ └─ timeZone	body	string		Terminal location time zone
‎‎ ‎ └─ address	body	common-Address		Address and contact details
‎‎ ‎ ‎‎ ‎ └─ zip	body	string
‎‎ ‎ ‎‎ ‎ └─ country	body	integer		ISO numeric code
‎‎ ‎ ‎‎ ‎ └─ region	body	string
‎‎ ‎ ‎‎ ‎ └─ regionRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ └─ area	body	string
‎‎ ‎ ‎‎ ‎ └─ areaRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ └─ city	body	string
‎‎ ‎ ‎‎ ‎ └─ cityRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ └─ street	body	string
‎‎ ‎ ‎‎ ‎ └─ streetRid	body	string		RID in the address database
‎‎ ‎ ‎‎ ‎ └─ house	body	string
‎‎ ‎ ‎‎ ‎ └─ building	body	string
‎‎ ‎ ‎‎ ‎ └─ construction	body	string
‎‎ ‎ ‎‎ ‎ └─ flat	body	string
‎‎ ‎ ‎‎ ‎ └─ addressInCity	body	string
‎‎ ‎ ‎‎ ‎ └─ addressInCountry	body	string
‎‎ ‎ ‎‎ ‎ └─ recipientName	body	string
‎‎ ‎ ‎‎ ‎ └─ phone	body	string
‎‎ ‎ ‎‎ ‎ └─ fax	body	string
‎‎ ‎ ‎‎ ‎ └─ mobile	body	string
‎‎ ‎ ‎‎ ‎ └─ email	body	string
‎‎ ‎ ‎‎ ‎ └─ url	body	string
‎‎ ‎ └─ keys	body	object		Terminal keys
‎‎ ‎ ‎‎ ‎ └─ pmk	body	common-CryptoKeyRef		Reference to the crypto key
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ pwk	body	common-CryptoKeyRef		Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ mmk	body	common-CryptoKeyRef		Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ mwk	body	common-CryptoKeyRef		Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ emk	body	common-CryptoKeyRef		Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ ewk	body	common-CryptoKeyRef		Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ rkl	body	common-CryptoKeyRef		Reference to the crypto key
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete terminal

DELETE /tx/v1/terminal

Deletes the existing terminal

Parameters

Name	In	Type	Required	Description
ref	query	terminal-TerminalRef	✔	Reference to the terminal

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList terminals

GET /tx/v1/terminals

Gets the list of terminals. This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
filter	query	TerminalsFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	TerminalsOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 1746,
        "rid": "T73",
        "extRid": "ET73"
      },
      "name": "string",
      "title": "string",
      "className": "string",
      "type": "string",
      "status": "string",
      "branch": {
        "id": 1746,
        "rid": "B3",
        "code": "BB2"
      },
      "merchantServiceContract": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "settings": {
        "id": 564,
        "rid": "POS23"
      },
      "config": {
        "id": 564,
        "rid": "Ab23"
      },
      "cashAccountingSchemeRid": {
        "id": 1746,
        "rid": "ET73"
      },
      "surchargeTariffPlan": {
        "id": "BHUMNF5OOJEH7AWVPAHS2OY6XYXX",
        "rid": "TP23"
      },
      "restrictionsProfile": {
        "id": 6846,
        "rid": "RPRID78"
      },
      "mcc": 5942,
      "defaultCurrency": "USD",
      "defaultLanguage": "string",
      "timeZone": "UTC",
      "address": {
        "zip": "NG71AE",
        "country": 0,
        "region": "CAL",
        "regionRid": "string",
        "area": "Nord",
        "areaRid": "string",
        "city": "Homeburg",
        "cityRid": "string",
        "street": "Broadway",
        "streetRid": "string",
        "house": 15,
        "building": 2,
        "construction": 1,
        "flat": 4,
        "addressInCity": null,
        "addressInCountry": null,
        "recipientName": "Robert Smith",
        "phone": 976356838473,
        "fax": null,
        "mobile": 976356838473,
        "email": "r.smith@mymail.net",
        "url": null
      },
      "keys": {
        "pmk": {
          "id": 1746
        },
        "pwk": {
          "id": 1746
        },
        "mmk": {
          "id": 1746
        },
        "mwk": {
          "id": 1746
        },
        "emk": {
          "id": 1746
        },
        "ewk": {
          "id": 1746
        },
        "rkl": {
          "id": 1746
        }
      },
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[terminal]			Contains the returned terminals
‎‎ ‎ └─ ref	terminal-TerminalRef			References to the terminal
‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	string			External reference ID
‎‎ ‎ └─ name	string			TID
‎‎ ‎ └─ title	string
‎‎ ‎ └─ className	string			classGuid
‎‎ ‎ └─ type	string
‎‎ ‎ └─ status	string
‎‎ ‎ └─ branch	common-BranchRef			Reference to the branch
‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ code	string			Code
‎‎ ‎ └─ merchantServiceContract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	string			Contract external reference ID
‎‎ ‎ └─ settings	terminal-settings-TerminalSettingsRef			Reference to the terminal settings
‎‎ ‎ ‎‎ ‎ └─ id	integer			Terminal settings ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Terminal settings reference ID
‎‎ ‎ └─ config	terminal-config-TermConfigRef			Reference to the terminal configuration
‎‎ ‎ ‎‎ ‎ └─ id	integer			Terminal configuration ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Terminal configuration reference ID
‎‎ ‎ └─ cashAccountingSchemeRid	terminal-CashAccountingSchemeRef			Reference to the cash accounting scheme (cash profile)
‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ └─ surchargeTariffPlan	surcharge-tariff-plan-SurchargeTariffPlanRef			Reference to the surcharge tariff plan
‎‎ ‎ ‎‎ ‎ └─ id	string			Tariff plan ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Tariff plan reference ID
‎‎ ‎ └─ restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile
‎‎ ‎ ‎‎ ‎ └─ id	integer			Restriction profile internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Restriction profile reference ID
‎‎ ‎ └─ mcc	integer			Merchant category code
‎‎ ‎ └─ defaultCurrency	string			Default terminal currency (alpha3 code)
‎‎ ‎ └─ defaultLanguage	string			Default terminal language (alpha2 code)
‎‎ ‎ └─ timeZone	string			Terminal location time zone
‎‎ ‎ └─ address	common-Address			Address and contact details
‎‎ ‎ ‎‎ ‎ └─ zip	string
‎‎ ‎ ‎‎ ‎ └─ country	integer			ISO numeric code
‎‎ ‎ ‎‎ ‎ └─ region	string
‎‎ ‎ ‎‎ ‎ └─ regionRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ └─ area	string
‎‎ ‎ ‎‎ ‎ └─ areaRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ └─ city	string
‎‎ ‎ ‎‎ ‎ └─ cityRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ └─ street	string
‎‎ ‎ ‎‎ ‎ └─ streetRid	string			RID in the address database
‎‎ ‎ ‎‎ ‎ └─ house	string
‎‎ ‎ ‎‎ ‎ └─ building	string
‎‎ ‎ ‎‎ ‎ └─ construction	string
‎‎ ‎ ‎‎ ‎ └─ flat	string
‎‎ ‎ ‎‎ ‎ └─ addressInCity	string
‎‎ ‎ ‎‎ ‎ └─ addressInCountry	string
‎‎ ‎ ‎‎ ‎ └─ recipientName	string
‎‎ ‎ ‎‎ ‎ └─ phone	string
‎‎ ‎ ‎‎ ‎ └─ fax	string
‎‎ ‎ ‎‎ ‎ └─ mobile	string
‎‎ ‎ ‎‎ ‎ └─ email	string
‎‎ ‎ ‎‎ ‎ └─ url	string
‎‎ ‎ └─ keys	object			Terminal keys
‎‎ ‎ ‎‎ ‎ └─ pmk	common-CryptoKeyRef			Reference to the crypto key
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ └─ pwk	common-CryptoKeyRef			Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ mmk	common-CryptoKeyRef			Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ mwk	common-CryptoKeyRef			Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ emk	common-CryptoKeyRef			Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ ewk	common-CryptoKeyRef			Reference to the crypto key
‎‎ ‎ ‎‎ ‎ └─ rkl	common-CryptoKeyRef			Reference to the crypto key
‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	string			Value

GETList terminal configurations

GET /tx/v1/terminal-configs

Gets the list of available terminal configurations. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 564,
        "rid": "Ab23"
      },
      "className": "TermConfig.Tptp",
      "name": "string"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[terminal-config]			Contains the returned objects
‎‎ ‎ └─ ref	terminal-config-TermConfigRef			Reference to the terminal configuration
‎‎ ‎ ‎‎ ‎ └─ id	integer			Terminal configuration ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Terminal configuration reference ID
‎‎ ‎ └─ className	any			Terminal configuration class name
‎‎ ‎ └─ name	string			Terminal configuration name

GETList terminal settings

GET /tx/v1/terminal-settings

Gets the list of available terminal settings. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 564,
        "rid": "POS23"
      },
      "className": "TermSettings.Tptp",
      "name": "string"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[terminal-settings]			Contains the returned objects
‎‎ ‎ └─ ref	terminal-settings-TerminalSettingsRef			Reference to the terminal settings
‎‎ ‎ ‎‎ ‎ └─ id	integer			Terminal settings ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Terminal settings reference ID
‎‎ ‎ └─ className	any			Terminal settings class name
‎‎ ‎ └─ name	string			Terminal settings name

POSTAccount-to-account transfer

POST /tx/v1/tran/account2account

Performs the account-to-account transfer transaction (contract-to-contract in TranzAxis)

Request body

{
  "src": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "dst": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ src	body	contract-ContractRef	✔	References to the contract
‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ └─ extRid	body	string		Contract external reference ID
└─ dst	body	contract-ContractRef	✔	References to the contract
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTCard-to-account transfer

POST /tx/v1/tran/card2account

Performs the card-to-account transfer transaction (card-to-contract in TranzAxis)

Request body

{
  "src": {
    "pan": 7645346863537866000,
    "expDate": "2027-10-21",
    "cvv2": 222,
    "tds": {
      "version": 2.1,
      "networkType": "string",
      "eci": 5,
      "condition": "string",
      "cavv": 5,
      "dsTranId": 7976543639,
      "xid": "SGVsbG8sIFdvcmxkIQ"
    }
  },
  "dst": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ src	body	tran-SrcCard	✔	Source card details
‎‎ ‎ └─ pan	body	string	✔	Card PAN
‎‎ ‎ └─ expDate	body	string(date)	✔	Card expiration date
‎‎ ‎ └─ cvv2	body	string		Card CVV2
‎‎ ‎ └─ tds	body	object		E-commerce 3-D Secure details
‎‎ ‎ ‎‎ ‎ └─ version	body	string		3-D Secure (3DS) version, e.g. 1.0, 2.2, etc.
‎‎ ‎ ‎‎ ‎ └─ networkType	body	string		Network type
‎‎ ‎ ‎‎ ‎ └─ eci	body	string		Network-related E-commerce indicator
‎‎ ‎ ‎‎ ‎ └─ condition	body	string		3DS authentication conditions
‎‎ ‎ ‎‎ ‎ └─ cavv	body	string		3DS cardholder authentication verification value (CAVV)
‎‎ ‎ ‎‎ ‎ └─ dsTranId	body	string		Transaction ID from the Directory Server
‎‎ ‎ ‎‎ ‎ └─ xid	body	string		3DS XID parameter
└─ dst	body	contract-ContractRef	✔	References to the contract
‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ └─ extRid	body	string		Contract external reference ID
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTAccount-to-card transfer

POST /tx/v1/tran/account2card

Performs the account-to-card transfer transaction (contract-to-card in TranzAxis)

Request body

{
  "src": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "dst": {
    "pan": 6645346863537866000,
    "expDate": "2027-10-21"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ src	body	contract-ContractRef	✔	References to the contract
‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ └─ extRid	body	string		Contract external reference ID
└─ dst	body	tran-DstCard	✔	Destination card details
‎‎ ‎ └─ pan	body	string	✔	Card PAN
‎‎ ‎ └─ expDate	body	string(date)		Card expiration date
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTCard-to-card transfer

POST /tx/v1/tran/card2card

Performs the card-to-card transfer transaction

Request body

{
  "src": {
    "pan": 7645346863537866000,
    "expDate": "2027-10-21",
    "cvv2": 222,
    "tds": {
      "version": 2.1,
      "networkType": "string",
      "eci": 5,
      "condition": "string",
      "cavv": 5,
      "dsTranId": 7976543639,
      "xid": "SGVsbG8sIFdvcmxkIQ"
    }
  },
  "dst": {
    "pan": 6645346863537866000,
    "expDate": "2027-10-21"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ src	body	tran-SrcCard	✔	Source card details
‎‎ ‎ └─ pan	body	string	✔	Card PAN
‎‎ ‎ └─ expDate	body	string(date)	✔	Card expiration date
‎‎ ‎ └─ cvv2	body	string		Card CVV2
‎‎ ‎ └─ tds	body	object		E-commerce 3-D Secure details
‎‎ ‎ ‎‎ ‎ └─ version	body	string		3-D Secure (3DS) version, e.g. 1.0, 2.2, etc.
‎‎ ‎ ‎‎ ‎ └─ networkType	body	string		Network type
‎‎ ‎ ‎‎ ‎ └─ eci	body	string		Network-related E-commerce indicator
‎‎ ‎ ‎‎ ‎ └─ condition	body	string		3DS authentication conditions
‎‎ ‎ ‎‎ ‎ └─ cavv	body	string		3DS cardholder authentication verification value (CAVV)
‎‎ ‎ ‎‎ ‎ └─ dsTranId	body	string		Transaction ID from the Directory Server
‎‎ ‎ ‎‎ ‎ └─ xid	body	string		3DS XID parameter
└─ dst	body	tran-DstCard	✔	Destination card details
‎‎ ‎ └─ pan	body	string	✔	Card PAN
‎‎ ‎ └─ expDate	body	string(date)		Card expiration date
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTPerform payment to service provider

POST /tx/v1/tran/account2vendor

Performs payment from the customer account to the service provider (e.g. utility services, bills, etc.)

Request body

{
  "src": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "dst": {
    "rid": "SPRID865439"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "params": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ src	body	contract-ContractRef	✔	References to the contract
‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ └─ extRid	body	string		Contract external reference ID
└─ dst	body	tran-Vendor	✔	Reference to the service provider (payments)
‎‎ ‎ └─ rid	body	string	✔	Service provider reference ID (payee contract RID)
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ params	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTDebit account

POST /tx/v1/tran/account2fi

Performs the account debit transaction (contract-to-financial institution in TranzAxis). The destination amount is credited to the financial institution account according to the TranzAxis configuration.

Request body

{
  "src": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ src	body	contract-ContractRef	✔	References to the contract
‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ └─ extRid	body	string		Contract external reference ID
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTCredit account

POST /tx/v1/tran/fi2account

Performs the account credit transaction (financial institution-to-contract in TranzAxis). The source amount is debited from the financial institution account according to the TranzAxis configuration.

Request body

{
  "dst": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ dst	body	contract-ContractRef	✔	References to the contract
‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ └─ extRid	body	string		Contract external reference ID
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTCard purchase (e-commerce)

POST /tx/v1/tran/purchase

Performs the E-commerce purchase transactin using a card and terminal as parameters. This type of transaction is usually initiated by the acquirer after the request from the E-commerce merchant.

Request body

{
  "card": {
    "pan": 7645346863537866000,
    "expDate": "2027-10-21",
    "cvv2": 222,
    "tds": {
      "version": 2.1,
      "networkType": "string",
      "eci": 5,
      "condition": "string",
      "cavv": 5,
      "dsTranId": 7976543639,
      "xid": "SGVsbG8sIFdvcmxkIQ"
    }
  },
  "terminal": {
    "tid": "TID2468",
    "mid": "MID13579"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "lifePhase": "Auth",
  "specific": {
    "installment": {
      "byMerchant": {
        "typeId": 135,
        "trancheCnt": 5,
        "initialAmt": 237
      },
      "byIssuer": {
        "planId": "CRID245",
        "trancheCnt": 6
      }
    }
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ card	body	tran-SrcCard	✔	Source card details
‎‎ ‎ └─ pan	body	string	✔	Card PAN
‎‎ ‎ └─ expDate	body	string(date)	✔	Card expiration date
‎‎ ‎ └─ cvv2	body	string		Card CVV2
‎‎ ‎ └─ tds	body	object		E-commerce 3-D Secure details
‎‎ ‎ ‎‎ ‎ └─ version	body	string		3-D Secure (3DS) version, e.g. 1.0, 2.2, etc.
‎‎ ‎ ‎‎ ‎ └─ networkType	body	string		Network type
‎‎ ‎ ‎‎ ‎ └─ eci	body	string		Network-related E-commerce indicator
‎‎ ‎ ‎‎ ‎ └─ condition	body	string		3DS authentication conditions
‎‎ ‎ ‎‎ ‎ └─ cavv	body	string		3DS cardholder authentication verification value (CAVV)
‎‎ ‎ ‎‎ ‎ └─ dsTranId	body	string		Transaction ID from the Directory Server
‎‎ ‎ ‎‎ ‎ └─ xid	body	string		3DS XID parameter
└─ terminal	body	object	✔	Merchant and terminal details
‎‎ ‎ └─ tid	body	string		Terminal ID. In TranzAxis, the value is usually stored in the Terminal RID field.
‎‎ ‎ └─ mid	body	string		Merchant ID
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ lifePhase	body	string		Transaction lifecycle phase, i.e. Authorization, Presentment, Single
└─ specific	body	object
‎‎ ‎ └─ installment	body	tran-InstallmentRq		Parameters related to the installment management request
‎‎ ‎ ‎‎ ‎ └─ byMerchant	body	object		Installment funded by the merchant
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ typeId	body	integer		Installment-related contract type ID in TranzAxis
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ trancheCnt	body	integer		Number of installments (without initial payment)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ initialAmt	body	number		Minimum initial payment amount in transaction currency
‎‎ ‎ ‎‎ ‎ └─ byIssuer	body	object		Installment funded by the issuer or financial institution
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ planId	body	string		Installment plan ID as installment-related contract type RID in TranzAxis
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ trancheCnt	body	integer		Number of installments
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "installment": {
    "byMerchant": {
      "tranches": [
        {
          "mainAmt": 237,
          "surchargeAmt": 5
        }
      ]
    },
    "byIssuer": {
      "contractTypeId": 135,
      "trancheCnt": 6,
      "apr": 4,
      "interestRate": 3
    }
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ tranId	integer			Unique transaction ID in the system
└─ approvalCode	string
└─ installment	tran-InstallmentRs			Parameters related to the installment management response
‎‎ ‎ └─ byMerchant	object			Installment funded by the merchant
‎‎ ‎ ‎‎ ‎ └─ tranches	[object]			List of installments
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mainAmt	number			Amount in currency in which the customer was serviced (as specified in the payment transaction)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ surchargeAmt	number			Surcharge amount, if applicable (in currency in which the customer was serviced, as specified in the payment transaction)
‎‎ ‎ └─ byIssuer	tran-InstallmentRs/properties/byIssuer			Installment funded by the issuer or financial institution
‎‎ ‎ ‎‎ ‎ └─ contractTypeId	integer			Installment-related contract type ID in TranzAxis
‎‎ ‎ ‎‎ ‎ └─ trancheCnt	integer			Number of installments
‎‎ ‎ ‎‎ ‎ └─ apr	number			Annual percentage rate
‎‎ ‎ ‎‎ ‎ └─ interestRate	number			Interest rate

POSTIssuer-funded post-purchase installment

POST /tx/v1/tran/{tranId}/installment

Converts the specified transaction to installment

Request body

{
  "contractTypeId": 135,
  "trancheCnt": 6,
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
tranId	path	integer	✔	Transaction ID
body	body	object	✔
└─ contractTypeId	body	integer	✔	Installment-related contract type ID in TranzAxis
└─ trancheCnt	body	integer	✔	Number of installments
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTMerchandise return / refund

POST /tx/v1/tran/refund

Refunds the card transaction amount

Request body

{
  "card": {
    "pan": 6645346863537866000,
    "expDate": "2027-10-21"
  },
  "terminal": {
    "tid": "string",
    "mid": "string"
  },
  "value": {
    "amt": 20,
    "ccy": "USD"
  },
  "refundedTran": {
    "id": 7875458909934,
    "matchKey": "trnaadgk1357924680",
    "rqSentTime": "2020-10-21T14:15:00"
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ card	body	tran-DstCard	✔	Destination card details
‎‎ ‎ └─ pan	body	string	✔	Card PAN
‎‎ ‎ └─ expDate	body	string(date)		Card expiration date
└─ terminal	body	object	✔	Merchant terminal details
‎‎ ‎ └─ tid	body	string		Terminal ID. In TranzAxis, the value is usually stored in the Terminal RID field.
‎‎ ‎ └─ mid	body	string		Merchant ID
└─ value	body	common-MonetaryValue	✔	Amount and currency
‎‎ ‎ └─ amt	body	number		Amount
‎‎ ‎ └─ ccy	body	string		Alpha3 currency code
└─ refundedTran	body	tran-TranRef		References to the transaction
‎‎ ‎ └─ id	body	integer		Transaction internal ID
‎‎ ‎ └─ matchKey	body	string		Transaction matching key assigned. Used in TranzAxis for transactions matching and passed in the specific field in the request body - /tranRq/match/key.
‎‎ ‎ └─ rqSentTime	body	string(date-time)		Date and time when the transaction request was sent to the system. The system matchs matchKey and transaction regTime within the following windowframe - rqSentTime <= regTimeand <= rqSentTime + 60s.
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

POSTReverse transaction

POST /tx/v1/tran/reversal

Performs the transaction reversal

Request body

{
  "reversedTran": {
    "id": 7875458909934,
    "matchKey": "trnaadgk1357924680",
    "rqSentTime": "2020-10-21T14:15:00"
  },
  "reason": "string",
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	✔
└─ reversedTran	body	tran-TranRef	✔	References to the transaction
‎‎ ‎ └─ id	body	integer		Transaction internal ID
‎‎ ‎ └─ matchKey	body	string		Transaction matching key assigned. Used in TranzAxis for transactions matching and passed in the specific field in the request body - /tranRq/match/key.
‎‎ ‎ └─ rqSentTime	body	string(date-time)		Date and time when the transaction request was sent to the system. The system matchs matchKey and transaction regTime within the following windowframe - rqSentTime <= regTimeand <= rqSentTime + 60s.
└─ reason	body	string		Reversal reason
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETGet transaction details

GET /tx/v1/tran

Retrieves the transaction details by reference

Parameters

Name	In	Type	Required	Description
ref	query	tran-TranRef	✔	Reference to the transaction

Example responses

200 Response

{
  "id": 799265548903,
  "regTime": "2020-10-21T14:15:00",
  "operDay": "2020-10-21",
  "lifePhase": "string",
  "kind": "Goods",
  "isReversal": false,
  "network": {
    "id": 3,
    "code": "ID3",
    "type": "string"
  },
  "src": {
    "card": {
      "panMask": "764534*******6533",
      "expDate": "2027-10-21"
    },
    "contract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    }
  },
  "dst": {
    "card": {
      "panMask": "664534*******6533",
      "expDate": "2028-10-21"
    },
    "contract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "vendor": {
      "rid": "SPRID865439"
    }
  },
  "terminal": {
    "name": "TPOS763583",
    "type": "Ecom",
    "countryCode": 840,
    "owner": {
      "mcc": 5992
    }
  },
  "values": {
    "customer": {
      "amt": 20.54,
      "ccy": "USD"
    },
    "clearing": {
      "amt": 20.54,
      "ccy": "USD"
    }
  },
  "result": "Approved",
  "details": {
    "rtpRequest": "string",
    "rtpResponse": "string"
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	tran
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

GETList card or account transactions

GET /tx/v1/trans

Gets the list of transactions for a card or account (contract). This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
card	query	card-CardRef		Reference to the card
contract	query	contract-ContractRef		Reference to the contract
filter	query	TransFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	TransOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "id": 799265548903,
      "regTime": "2020-10-21T14:15:00",
      "operDay": "2020-10-21",
      "lifePhase": "string",
      "kind": "Goods",
      "isReversal": false,
      "network": {
        "id": 3,
        "code": "ID3",
        "type": "string"
      },
      "src": {
        "card": {
          "panMask": "764534*******6533",
          "expDate": "2027-10-21"
        },
        "contract": {
          "id": 4680,
          "rid": "CRID4542809",
          "extRid": "CASA1268"
        }
      },
      "dst": {
        "card": {
          "panMask": "664534*******6533",
          "expDate": "2028-10-21"
        },
        "contract": {
          "id": 4680,
          "rid": "CRID4542809",
          "extRid": "CASA1268"
        },
        "vendor": {
          "rid": "SPRID865439"
        }
      },
      "terminal": {
        "name": "TPOS763583",
        "type": "Ecom",
        "countryCode": 840,
        "owner": {
          "mcc": 5992
        }
      },
      "values": {
        "customer": {
          "amt": 20.54,
          "ccy": "USD"
        },
        "clearing": {
          "amt": 20.54,
          "ccy": "USD"
        }
      },
      "result": "Approved",
      "details": {
        "rtpRequest": "string",
        "rtpResponse": "string"
      }
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[tran]			Contains the returned transactions (without details)
‎‎ ‎ └─ id	string			Unique transaction ID
‎‎ ‎ └─ regTime	string(date-time)			System date and time when the transaction was registered
‎‎ ‎ └─ operDay	string(date)			Business day when the transaction was processed
‎‎ ‎ └─ lifePhase	string			Transaction lifecycle phase. Lifecycle phase represents different states of a transaction, e.g. Authorization, Presentment, Chargeback, etc.
‎‎ ‎ └─ kind	string			Transaction type, e.g. Purchase, Payment, Deposit, etc. TranzAxis supported many types (kinds) of transactions, not all of them may be relevant to your project. Please check with the project team which transaction types are applicable.
‎‎ ‎ └─ isReversal	boolean			Indicates that the transaction is a reversal. true indicates that the transaction is a reversal.
‎‎ ‎ └─ network	object			Payment network details (if the transaction is processed through the network)
‎‎ ‎ ‎‎ ‎ └─ id	integer			Network internal ID
‎‎ ‎ ‎‎ ‎ └─ code	string			Network reference code
‎‎ ‎ ‎‎ ‎ └─ type	string			Network type
‎‎ ‎ └─ src	object			Payment source (card or account/contract)
‎‎ ‎ ‎‎ ‎ └─ card	object			Source card details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ panMask	string			Card PAN (masked)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ expDate	string(date)			Card expiration date
‎‎ ‎ ‎‎ ‎ └─ contract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract internal ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract reference ID
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ extRid	string			Contract external reference ID
‎‎ ‎ └─ dst	object			Payment destination (card / account / vendor)
‎‎ ‎ ‎‎ ‎ └─ card	object			Destination card details
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ panMask	string			Card PAN (masked)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ expDate	string(date)			Card expiration date
‎‎ ‎ ‎‎ ‎ └─ contract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ └─ vendor	tran-Vendor			Reference to the service provider (payments)
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ rid	string	✔		Service provider reference ID (payee contract RID)
‎‎ ‎ └─ terminal	object			Terminal details
‎‎ ‎ ‎‎ ‎ └─ name	string			Terminal name
‎‎ ‎ ‎‎ ‎ └─ type	string			Terminal type
‎‎ ‎ ‎‎ ‎ └─ countryCode	integer			Terminal country (ISO 3-digit country code)
‎‎ ‎ ‎‎ ‎ └─ owner	object
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ mcc	integer			Merchant category code, e.g. as used in merchant acquiring (4-digit ISO MCC for financial retail services)
‎‎ ‎ └─ values	object			Transaction amounts
‎‎ ‎ ‎‎ ‎ └─ customer	object			Customer billing amount
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ amt	number			Transaction billing amount
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ccy	string			Transaction billing currency (alpha3 currency code)
‎‎ ‎ ‎‎ ‎ └─ clearing	object			Clearing amount
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ amt	number			Transaction clearing amount
‎‎ ‎ ‎‎ ‎ ‎‎ ‎ └─ ccy	string			Transaction clearing currency (alpha3 currency code)
‎‎ ‎ └─ result	string			Transaction processing result in TranzAxis
‎‎ ‎ └─ details	object			Additional information on the transaction (returned for the GET Tran operation only). This is the TranzAxis native transaction representation as stored in TranzAxis in RTP format.
‎‎ ‎ ‎‎ ‎ └─ rtpRequest	string			RTP request details (XML)
‎‎ ‎ ‎‎ ‎ └─ rtpResponse	string			RTP response details (XML)

GETList of available installment plans

GET /tx/v1/tran/{tranId}/installment/plans

Returns the list of available installment plans (contract type IDs) for a transaction, e.g. for issuer-funded post-purchase installment

Parameters

Name	In	Type	Required	Description
tranId	path	integer	✔	Transaction ID to be converted to installment

Example responses

200 Response

{
  "plans": [
    {
      "contractTypeId": 135,
      "trancheCnt": 6,
      "apr": 4,
      "interestRate": 3
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ plans	[tran-InstallmentRs/properties/byIssuer]			Available installment plans
‎‎ ‎ └─ contractTypeId	integer			Installment-related contract type ID in TranzAxis
‎‎ ‎ └─ trancheCnt	integer			Number of installments
‎‎ ‎ └─ apr	number			Annual percentage rate
‎‎ ‎ └─ interestRate	number			Interest rate

Applications

GETGet application

GET /tx/v1/application

Retrieves the application details

Parameters

Name	In	Type	Required	Description
ref	query	application-ApplicationRef	✔	Unique reference to the application

Example responses

200 Response

{
  "ref": {
    "id": 13579,
    "rid": "ARID24680",
    "key": "aadgk1357924680"
  },
  "customer": {
    "id": 1746,
    "rid": "PRID73"
  },
  "contract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "card": {
    "id": 13579,
    "rid": "CRDRID24680"
  },
  "type": {
    "id": 12,
    "rid": "ATRID12"
  },
  "status": "string",
  "prevStatus": "string",
  "name": "Sample application 1",
  "comments": "This is a test application",
  "times": {
    "creation": "2020-10-21T14:15:00",
    "finish": "2022-10-21T14:15:00"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	application
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
500	Internal Server Error	Internal server error

PUTCreate or update application

PUT /tx/v1/application

Creates a new application or updates the existing one

Request body

{
  "object": {
    "ref": {
      "id": 13579,
      "rid": "ARID24680",
      "key": "aadgk1357924680"
    },
    "customer": {
      "id": 1746,
      "rid": "PRID73"
    },
    "contract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "card": {
      "id": 13579,
      "rid": "CRDRID24680"
    },
    "type": {
      "id": 12,
      "rid": "ATRID12"
    },
    "status": "string",
    "prevStatus": "string",
    "name": "Sample application 1",
    "comments": "This is a test application",
    "times": {
      "creation": "2020-10-21T14:15:00",
      "finish": "2022-10-21T14:15:00"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  },
  "tranRq": {
    "clerkName": "Operator_1",
    "intMess": 7,
    "textMess": "TTY=8872;SHIF-6839;",
    "categoryCode": "TCC3",
    "categoryText": "Unhandled",
    "classification": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ],
    "match": {
      "key": "adgjl1357guid",
      "rrn": "RN6538303344"
    },
    "userAttrs": [
      {
        "rid": "UDPRID3",
        "val": "VAL-1"
      }
    ]
  }
}

Parameters

Name	In	Type	Required	Description
mustExist	query	boolean		Object presence control. Refer to section Idempotency to get more details on the parameter usage.
body	body	object
└─ object	body	application		Application object. Applications can be linked to customers, accounts (contracts) or cards.
‎‎ ‎ └─ ref	body	application-ApplicationRef		Unique references to the application
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Application internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Application reference ID
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Additional unique application key that can be used to quickly search for the application
‎‎ ‎ └─ customer	body	subject-SubjectRef		References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ └─ contract	body	contract-ContractRef		References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	body	string		Contract external reference ID
‎‎ ‎ └─ card	body	card-CardRef		References to the card
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Card internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Card reference ID
‎‎ ‎ └─ type	body	application-type-ApplicationTypeRef		Unique references to the application type
‎‎ ‎ ‎‎ ‎ └─ id	body	integer		Application type internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Application type reference ID
‎‎ ‎ └─ status	body	string		Application status
‎‎ ‎ └─ prevStatus	body	string		Previous application status
‎‎ ‎ └─ name	body	string		Application name
‎‎ ‎ └─ comments	body	string		Comment to the application
‎‎ ‎ └─ times	body	object
‎‎ ‎ ‎‎ ‎ └─ creation	body	string(date-time)		Date and time when the application was created
‎‎ ‎ ‎‎ ‎ └─ finish	body	string(date-time)		Date and time when the application was finally processed
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	body	string		Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	body	string		Value
└─ tranRq	body	common-TranRqExtraAttrs		Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)
‎‎ ‎ └─ clerkName	body	string		Operator name
‎‎ ‎ └─ intMess	body	integer		Message ID
‎‎ ‎ └─ textMess	body	string		Text message container
‎‎ ‎ └─ categoryCode	body	string		Transaction category code
‎‎ ‎ └─ categoryText	body	string		Transaction category name
‎‎ ‎ └─ classification	body	[common-UserAttr]		Container of user-defined attributes
‎‎ ‎ └─ match	body	common-TranMatch		Transaction matching properties
‎‎ ‎ ‎‎ ‎ └─ key	body	string		Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
‎‎ ‎ ‎‎ ‎ └─ rrn	body	string		Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.
‎‎ ‎ └─ userAttrs	body	[common-UserAttr]		Container of user-defined attributes

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-ModifyTranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

DELETEDelete application

DELETE /tx/v1/application

Deletes the existing application

Parameters

Name	In	Type	Required	Description
ref	query	application-ApplicationRef	✔	Unique reference to the application

Example responses

200 Response

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction approved	common-TranApproveRs
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
404	Not Found	Not found
422	Unprocessable Entity	Transaction declined	common-TranDeclineRs
500	Internal Server Error	Internal server error

GETList applications

GET /tx/v1/applications

Gets the list of applications for the customer. This endpoint supports filtering and sorting options, pagination.

Parameters

Name	In	Type	Required	Description
subject	query	subject-SubjectRef	✔	Unique reference to the customer
filter	query	ApplicationsFilter		Filter criteria. Refer to section Filtering to get more details on the parameter usage.
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.
order	query	ApplicationsOrder		Sorting option parameters. Refer to section Sorting to get more details on the parameter usage.

order ─ Enumerated Value

Value
IdAsc
IdDesc

Example responses

200 Response

{
  "hasMore": true,
  "objects": [
    {
      "ref": {
        "id": 13579,
        "rid": "ARID24680",
        "key": "aadgk1357924680"
      },
      "customer": {
        "id": 1746,
        "rid": "PRID73"
      },
      "contract": {
        "id": 4680,
        "rid": "CRID4542809",
        "extRid": "CASA1268"
      },
      "card": {
        "id": 13579,
        "rid": "CRDRID24680"
      },
      "type": {
        "id": 12,
        "rid": "ATRID12"
      },
      "status": "string",
      "prevStatus": "string",
      "name": "Sample application 1",
      "comments": "This is a test application",
      "times": {
        "creation": "2020-10-21T14:15:00",
        "finish": "2022-10-21T14:15:00"
      },
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad request
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal server error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[application]			Contains the returned applications.
‎‎ ‎ └─ ref	application-ApplicationRef			Unique references to the application
‎‎ ‎ ‎‎ ‎ └─ id	integer			Application internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Application reference ID
‎‎ ‎ ‎‎ ‎ └─ key	string			Additional unique application key that can be used to quickly search for the application
‎‎ ‎ └─ customer	subject-SubjectRef			References to the person/company
‎‎ ‎ ‎‎ ‎ └─ id	integer			Internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ └─ contract	contract-ContractRef			References to the contract
‎‎ ‎ ‎‎ ‎ └─ id	integer			Contract internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Contract reference ID
‎‎ ‎ ‎‎ ‎ └─ extRid	string			Contract external reference ID
‎‎ ‎ └─ card	card-CardRef			References to the card
‎‎ ‎ ‎‎ ‎ └─ id	integer			Card internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Card reference ID
‎‎ ‎ └─ type	application-type-ApplicationTypeRef			Unique references to the application type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Application type internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Application type reference ID
‎‎ ‎ └─ status	string			Application status
‎‎ ‎ └─ prevStatus	string			Previous application status
‎‎ ‎ └─ name	string			Application name
‎‎ ‎ └─ comments	string			Comment to the application
‎‎ ‎ └─ times	object
‎‎ ‎ ‎‎ ‎ └─ creation	string(date-time)			Date and time when the application was created
‎‎ ‎ ‎‎ ‎ └─ finish	string(date-time)			Date and time when the application was finally processed
‎‎ ‎ └─ userAttrs	[common-UserAttr]			Container of user-defined attributes
‎‎ ‎ ‎‎ ‎ └─ rid	string			Reference ID
‎‎ ‎ ‎‎ ‎ └─ val	string			Value

GETList application types

GET /tx/v1/application-types

Lists the available application types. This endpoint supports pagination.

Parameters

Name	In	Type	Required	Description
page	query	Pagination		Pagination parameters. Refer to section Pagination to get more details on the parameter usage.

Example responses

200 Response

{
  "hasMore": false,
  "objects": [
    {
      "ref": {
        "id": 12,
        "rid": "ATRID12"
      },
      "name": "Credit applications",
      "isAbstract": false,
      "parentType": {
        "id": 11,
        "rid": "ATRID11"
      }
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
401	Unauthorized	Unauthorized
403	Forbidden	Forbidden
500	Internal Server Error	Internal Server Error

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
└─ hasMore	boolean			Indicates that more objects can be fetched. true indicates that more objects to return exist.
└─ objects	[application-type]			Contains the returned application types
‎‎ ‎ └─ ref	application-type-ApplicationTypeRef			Unique references to the application type
‎‎ ‎ ‎‎ ‎ └─ id	integer			Application type internal ID
‎‎ ‎ ‎‎ ‎ └─ rid	string			Application type reference ID
‎‎ ‎ └─ name	string			Application type name
‎‎ ‎ └─ isAbstract	boolean			Indicates whether the application type can be used to create applications of this type. true indicates that the application type is abstract and is only used to build an hierarchy of application types.
‎‎ ‎ └─ parentType	application-type-ApplicationTypeRef			Unique references to the application type

Schemas

ApplicationsFilter

{
  "applicationTypeId": 12,
  "applicationTypeRid": "ATRID12",
  "status": "string"
}

Properties

Name	Type	Required	Restrictions	Description
applicationTypeId	integer			Application type ID
applicationTypeRid	string			Application type reference ID
status	string			Application status

ApplicationsOrder

"IdAsc"

Field to sort by (in ascending or descending order) - application ID.

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending or descending order) - application ID.

Enumerated Values

Property	Value
	IdAsc
	IdDesc

CardsFilter

{
  "holderId": 23579,
  "holderRid": "CH56357",
  "status": "string"
}

Either holderId or holderRid is required.

Properties

Name	Type	Required	Restrictions	Description
holderId	integer			Cardholder internal ID
holderRid	string			Cardholder reference ID
status	string			Card status

CardsOrder

"IdAsc"

Field to sort by (in ascending, descending order) - card ID

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending, descending order) - card ID

Enumerated Values

Property	Value
	IdAsc
	IdDesc

CountersToReset

{
  "invalidCvv2TriesCnt": true,
  "invalidIPinTriesCnt": true,
  "invalidPinTriesCnt": true,
  "invalidTdsEnrollTriesCnt": true,
  "invalidPersonAnswerTriesCnt": true,
  "invalidCallbackTriesCnt": true,
  "invalidPasswordTriesCnt": true
}

Properties

Name	Type	Required	Restrictions	Description
invalidCvv2TriesCnt	boolean			Number of incorrect CVV2 attempts
invalidIPinTriesCnt	boolean			Number of incorrect IPIN attempts
invalidPinTriesCnt	boolean			Number of incorrect PIN attempts
invalidTdsEnrollTriesCnt	boolean			Number of unsuccessful 3-D Secure enrollment authentication attempts
invalidPersonAnswerTriesCnt	boolean			Number of incorrect answers to authentication question
invalidCallbackTriesCnt	boolean			Number of incorrect one-time password attempts
invalidPasswordTriesCnt	boolean			Number of incorrect password attempts

Pagination

{
  "offset": 0,
  "limit": 100
}

Pagination parameters

Properties

Name	Type	Required	Restrictions	Description
offset	integer			Page start offset (>=0)
limit	integer			Page length

ContractsFilter

{
  "clientId": 3579,
  "clientRid": "CSTRID765739",
  "typeId": 865,
  "typeRid": "CNTTRID4689",
  "status": "string"
}

Either clientId or clientRid is required.

Properties

Name	Type	Required	Restrictions	Description
clientId	integer			Customer internal ID
clientRid	string			Customer reference ID
typeId	integer			Contract type internal ID
typeRid	string			Contract type reference ID
status	string			Contract status

ContractsOrder

"IdAsc"

Field to sort by (in ascending, descending order) - contract ID

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending, descending order) - contract ID

Enumerated Values

Property	Value
	IdAsc
	IdDesc

Contract2ContractsFilter

{
  "contract1Id": 0,
  "contract1Rid": "string",
  "contract2Id": 0,
  "contract2Rid": "string",
  "kind": "string",
  "status": "string"
}

Properties

Name	Type	Required	Restrictions	Description
contract1Id	integer			ID of contract 1
contract1Rid	string			Reference ID of contract 1
contract2Id	integer			ID of contract 2
contract2Rid	string			Reference ID of contract 2
kind	string			Link type
status	string			Link status

Contract2ContractsOrder

"IdAsc"

Field to sort by (in ascending, descending order) - Link ID, Link sequence number

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending, descending order) - Link ID, Link sequence number

Enumerated Values

Property	Value
	IdAsc
	IdDesc
	SeqAsc
	SeqDesc

SubjectsFilter

{
  "kind": "Person",
  "firstNameLike": "john%",
  "lastNameLike": "do%",
  "birthDate": "2000-10-21",
  "nameLike": "com%",
  "parentId": 8267,
  "parentRid": "PCRID0735"
}

Properties

Name	Type	Required	Restrictions	Description
kind	subject-SubjectKind	✔		Subject type
firstNameLike	string			String partially matching the first name (applicable for "person" only). The search is not case-sensitive, wildcards supported - the percent sign (%) шы гыув to substitute a group of characters, and the underscore (_) - to substitute one character
lastNameLike	string			String partially matching the last name (applicable for "person" only). The search is not case-sensitive, wildcards supported - the percent sign (%) is used to substitute a group of characters, and the underscore (_) - to substitute one character
birthDate	string(date)			Birthdate (applicable for "person" only)
nameLike	string			String partially matching the company name (applicable for "company" only). The search is not case-sensitive, wildcards supported - the percent sign (%) is used to substitute a group of characters, and the underscore (_) - to substitute one character.
parentId	integer			Parent company ID (applicable for "company" only)
parentRid	string			Parent company reference ID (applicable for "company" only)

SubjectsOrder

"IdAsc"

Field to sort by (in ascending, descending order) - ID, Reference ID, Name (last name, first name; company name)

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending, descending order) - ID, Reference ID, Name (last name, first name; company name)

Enumerated Values

Property	Value
	IdAsc
	IdDesc
	RidAsc
	RidDesc
	NameAsc
	NameDesc

SubjectDocumentsFilter

{
  "subjectId": 7393,
  "subjectRid": "SRID73"
}

Either subjectId or subjectRid is required

Properties

Name	Type	Required	Restrictions	Description
subjectId	integer			Person/company internal ID
subjectRid	string			Person/company reference ID

SubjectDocumentsOrder

"IdAsc"

Field to sort by (in ascending, descending order) - document ID

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending, descending order) - document ID

Enumerated Values

Property	Value
	IdAsc
	IdDesc

TerminalsFilter

{
  "type": "string",
  "status": "string"
}

Properties

Name	Type	Required	Restrictions	Description
type	string
status	string

TerminalsOrder

"IdAsc"

Field to sort by (in ascending, descending order)

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending, descending order)

Enumerated Values

Property	Value
	IdAsc
	IdDesc

TransFilter

{
  "begTime": "2020-10-21T00:00:00",
  "endTime": "2020-10-22T14:15:00"
}

Properties

Name	Type	Required	Restrictions	Description
begTime	string(date-time)			Transaction date, from
endTime	string(date-time)			Transaction date, to

TransOrder

"IdAsc"

Field to sort by (in ascending, descending order) - transaction ID

Properties

Name	Type	Required	Restrictions	Description
	string			Field to sort by (in ascending, descending order) - transaction ID

Enumerated Values

Property	Value
	IdAsc
	IdDesc

subject-NetworkSpecAttr

{
  "networkName": "string",
  "toDelete": true,
  "rid": "string",
  "merchantRid": "string",
  "singleMerchantRid": "string",
  "name": "string",
  "mcc": "string"
}

Network-specific attribute

Properties

Name	Type	Required	Restrictions	Description
networkName	string			Network name
toDelete	boolean			Delete this attribute
rid	string			Reference ID
merchantRid	string			Merchant reference ID
singleMerchantRid	string			Single merchant reference ID
name	string			Name
mcc	string			MCC

notification-type-NotificationTypeRef

{
  "id": 87648,
  "rid": "NTRID878"
}

References to the notification type

Properties

Name	Type	Required	Restrictions	Description
id	integer			Notification type ID
rid	string			Notification type reference ID

restriction-OwnerRef

{
  "ownerType": "Contract",
  "ownerId": 4756
}

Reference to the restriction owner (object the restriction is applied to)

Properties

Name	Type	Required	Restrictions	Description
ownerType	string			Restriction owner type
ownerId	integer			Owner ID (primary key)

Enumerated Values

Property	Value
ownerType	Contract
ownerType	Terminal
ownerType	Token
ownerType	Subject

subject-type-SubjectTypeRef

{
  "id": 564,
  "rid": "STRID23"
}

Reference to the subject type

Properties

Name	Type	Required	Restrictions	Description
id	integer			Subject type ID
rid	string			Subject type reference ID

application

{
  "ref": {
    "id": 13579,
    "rid": "ARID24680",
    "key": "aadgk1357924680"
  },
  "customer": {
    "id": 1746,
    "rid": "PRID73"
  },
  "contract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "card": {
    "id": 13579,
    "rid": "CRDRID24680"
  },
  "type": {
    "id": 12,
    "rid": "ATRID12"
  },
  "status": "string",
  "prevStatus": "string",
  "name": "Sample application 1",
  "comments": "This is a test application",
  "times": {
    "creation": "2020-10-21T14:15:00",
    "finish": "2022-10-21T14:15:00"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Application object. Applications can be linked to customers, accounts (contracts) or cards.

Properties

Name	Type	Required	Restrictions	Description
ref	application-ApplicationRef			Unique references to the application
customer	subject-SubjectRef			References to the person/company
contract	contract-ContractRef			References to the contract
card	card-CardRef			References to the card
type	application-type-ApplicationTypeRef			Unique references to the application type
status	string			Application status
prevStatus	string			Previous application status
name	string			Application name
comments	string			Comment to the application
times	object
└─ creation	string(date-time)			Date and time when the application was created
└─ finish	string(date-time)			Date and time when the application was finally processed
userAttrs	common-UserAttrs			Application data presented as a set of attributes

tran

{
  "id": 799265548903,
  "regTime": "2020-10-21T14:15:00",
  "operDay": "2020-10-21",
  "lifePhase": "string",
  "kind": "Goods",
  "isReversal": false,
  "network": {
    "id": 3,
    "code": "ID3",
    "type": "string"
  },
  "src": {
    "card": {
      "panMask": "764534*******6533",
      "expDate": "2027-10-21"
    },
    "contract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    }
  },
  "dst": {
    "card": {
      "panMask": "664534*******6533",
      "expDate": "2028-10-21"
    },
    "contract": {
      "id": 4680,
      "rid": "CRID4542809",
      "extRid": "CASA1268"
    },
    "vendor": {
      "rid": "SPRID865439"
    }
  },
  "terminal": {
    "name": "TPOS763583",
    "type": "Ecom",
    "countryCode": 840,
    "owner": {
      "mcc": 5992
    }
  },
  "values": {
    "customer": {
      "amt": 20.54,
      "ccy": "USD"
    },
    "clearing": {
      "amt": 20.54,
      "ccy": "USD"
    }
  },
  "result": "Approved",
  "details": {
    "rtpRequest": "string",
    "rtpResponse": "string"
  }
}

Transaction object. Transaction represents any operation in TranzAxis processed by the system (includes both financial and non-financial operations).

Properties

Name	Type	Required	Restrictions	Description
id	string			Unique transaction ID
regTime	string(date-time)			System date and time when the transaction was registered
operDay	string(date)			Business day when the transaction was processed
lifePhase	string			Transaction lifecycle phase. Lifecycle phase represents different states of a transaction, e.g. Authorization, Presentment, Chargeback, etc.
kind	string			Transaction type, e.g. Purchase, Payment, Deposit, etc. TranzAxis supported many types (kinds) of transactions, not all of them may be relevant to your project. Please check with the project team which transaction types are applicable.
isReversal	boolean			Indicates that the transaction is a reversal. true indicates that the transaction is a reversal.
network	object			Payment network details (if the transaction is processed through the network)
└─ id	integer			Network internal ID
└─ code	string			Network reference code
└─ type	string			Network type
src	object			Payment source (card or account/contract)
└─ card	object			Source card details
‎‎ ‎ └─ panMask	string			Card PAN (masked)
‎‎ ‎ └─ expDate	string(date)			Card expiration date
└─ contract	contract-ContractRef			Source account (contract) details
dst	object			Payment destination (card / account / vendor)
└─ card	object			Destination card details
‎‎ ‎ └─ panMask	string			Card PAN (masked)
‎‎ ‎ └─ expDate	string(date)			Card expiration date
└─ contract	contract-ContractRef			Destination account (contract) details
└─ vendor	tran-Vendor			Service provider details
terminal	object			Terminal details
└─ name	string			Terminal name
└─ type	string			Terminal type
└─ countryCode	integer			Terminal country (ISO 3-digit country code)
└─ owner	object
‎‎ ‎ └─ mcc	integer			Merchant category code, e.g. as used in merchant acquiring (4-digit ISO MCC for financial retail services)
values	object			Transaction amounts
└─ customer	object			Customer billing amount
‎‎ ‎ └─ amt	number			Transaction billing amount
‎‎ ‎ └─ ccy	string			Transaction billing currency (alpha3 currency code)
└─ clearing	object			Clearing amount
‎‎ ‎ └─ amt	number			Transaction clearing amount
‎‎ ‎ └─ ccy	string			Transaction clearing currency (alpha3 currency code)
result	string			Transaction processing result in TranzAxis
details	object			Additional information on the transaction (returned for the GET Tran operation only). This is the TranzAxis native transaction representation as stored in TranzAxis in RTP format.
└─ rtpRequest	string			RTP request details (XML)
└─ rtpResponse	string			RTP response details (XML)

tran-DstCard

{
  "pan": 6645346863537866000,
  "expDate": "2027-10-21"
}

Destination card details

Properties

Name	Type	Required	Restrictions	Description
pan	string	✔		Card PAN
expDate	string(date)			Card expiration date

subject-auth_qa

{
  "question": "Name of the first pet",
  "answer": "Rocket"
}

Personal authentication question and answer (security questions)

Properties

Name	Type	Required	Restrictions	Description
question	string			Personal authentication question
answer	string			Personal authentication answer

terminal-settings

{
  "ref": {
    "id": 564,
    "rid": "POS23"
  },
  "className": "TermSettings.Tptp",
  "name": "string"
}

Terminal Settings object

Properties

Name	Type	Required	Restrictions	Description
ref	terminal-settings-TerminalSettingsRef			Reference to the terminal settings
className	any			Terminal settings class name
name	string			Terminal settings name

tran-InstallmentRs

{
  "byMerchant": {
    "tranches": [
      {
        "mainAmt": 237,
        "surchargeAmt": 5
      }
    ]
  },
  "byIssuer": {
    "contractTypeId": 135,
    "trancheCnt": 6,
    "apr": 4,
    "interestRate": 3
  }
}

Parameters related to the installment management response

Properties

Name	Type	Required	Restrictions	Description
byMerchant	object			Installment funded by the merchant
└─ tranches	[object]			List of installments
‎‎ ‎ └─ mainAmt	number			Amount in currency in which the customer was serviced (as specified in the payment transaction)
‎‎ ‎ └─ surchargeAmt	number			Surcharge amount, if applicable (in currency in which the customer was serviced, as specified in the payment transaction)
byIssuer	object			Installment funded by the issuer or financial institution
└─ contractTypeId	integer			Installment-related contract type ID in TranzAxis
└─ trancheCnt	integer			Number of installments
└─ apr	number			Annual percentage rate
└─ interestRate	number			Interest rate

subject-SubjectRef

{
  "id": 1746,
  "rid": "PRID73"
}

References to the person/company

Properties

Name	Type	Required	Restrictions	Description
id	integer			Internal ID
rid	string			Reference ID

common-TranApproveRs

{
  "tranId": 1357924680,
  "approvalCode": "A200567"
}

Response for approved transaction

Properties

Name	Type	Required	Restrictions	Description
tranId	integer			Unique transaction ID in the system
approvalCode	string

subject-document

{
  "ref": {
    "id": 8737
  },
  "type": {
    "id": 56,
    "rid": "DTRID084"
  },
  "series": 7522,
  "country": 0,
  "regionRid": "string",
  "rid": 888122,
  "issuerName": "Regional security office",
  "issuerId": 2,
  "issuerRid": "Rid",
  "isActive": true,
  "issueDate": "2020-10-21",
  "expDate": "2035-10-21",
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Document object (passport, national ID, etc.)

Properties

Name	Type	Required	Restrictions	Description
ref	subject-document-SubjectDocumentRef			Reference to the document
type	subject-document-type-SubjectDocumentTypeRef			Reference to the document type
series	string			Document series or prefix. For example, some passports can contain two parts in its number – the series and the number itself, e.g. "7500 123456" as the full passport number.
country	integer			ISO numeric code
regionRid	string			RID in the address database
rid	string			Document number (reference ID)
issuerName	string			Entity that issued the document
issuerId	integer			Issuer identifier
issuerRid	string			Issuer reference identifier
isActive	boolean			Indicates that the document is active. true indicates that the document is active in TranzAxis.
issueDate	string(date)			Date when the document was issued
expDate	string(date)			Document expiration date
userAttrs	common-UserAttrs			User-defined attributes

card

{
  "ref": {
    "id": 13579,
    "rid": "CRDRID24680"
  },
  "className": "Smart cards",
  "holder": {
    "id": 1746,
    "rid": "PRID73"
  },
  "issuingContractType": {
    "id": 97548,
    "rid": "CTRID975"
  },
  "issuingContract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "financialContract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "mainCard": {
    "id": 13579,
    "rid": "CRDRID24680"
  },
  "product": {
    "id": 22,
    "rid": "CPRID22"
  },
  "design": {
    "id": 12,
    "rid": "DESRID12"
  },
  "panMask": "777777******6543",
  "mbr": 0,
  "status": "string",
  "lifePhaseRid": "LCRID_ATBRANCH",
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "tdsEnrollment": true,
  "logistics": {
    "deliveryBranchName": "Branch 1",
    "deliveryAddress": {
      "zip": "NG71AE",
      "country": 0,
      "region": "CAL",
      "regionRid": "string",
      "area": "Nord",
      "areaRid": "string",
      "city": "Homeburg",
      "cityRid": "string",
      "street": "Broadway",
      "streetRid": "string",
      "house": 15,
      "building": 2,
      "construction": 1,
      "flat": 4,
      "addressInCity": null,
      "addressInCountry": null,
      "recipientName": "Robert Smith",
      "phone": 976356838473,
      "fax": null,
      "mobile": 976356838473,
      "email": "r.smith@mymail.net",
      "url": null
    },
    "curBranchName": "Central office"
  },
  "names": {
    "emboss": "Smith",
    "track": "Smith",
    "print": "Smith"
  },
  "dates": {
    "validFrom": "2019-08-24",
    "creation": "2019-08-24",
    "activation": "2019-08-24",
    "expiration": "2019-08-24",
    "closure": "2019-08-24"
  },
  "notes": "Test card",
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Card object

Properties

Name	Type	Required	Restrictions	Description
ref	card-CardRef			References to the card
className	string			Card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
holder	subject-SubjectRef			Reference to the cardholder (customer)
issuingContractType	contract-type-ContractTypeRef			Reference to the "Issuing Contract Type" object in TranzAxis. Also refer to the issuingContract element.
issuingContract	contract-ContractRef			Reference to the "Issuing Contract" object in TranzAxis. All cards in TranzAxis are created within a specific object called "Issuing Contract", which usually describes the common features of card production and usage. "Issuing Contract" object belongs to the customer. Several cards can be created within the same issuing contract or each card can have a separate issuing contract. Either the issuingContract or issuingContractType value must be defined to create a new card. Refer to your TranzAxis configuration to obtain the correct value for the issuingContractType element. Also refer to the /contract endpoint for more details.
financialContract	contract-ContractRef			Reference to the "Financial Contract" object. Financial contract in TranzAxis represents a financial account(s) linked to the card. This property is used when the card is linked to one account only (the most common case), otherwise use the "contract2contract" linkage scheme instead. Also refer to the /contract and /contract2contract endpoints for more details.
mainCard	card-CardRef			Reference to the main card if the card is supplementary
product	card-product-CardProductRef			References to the card product
design	card-design-CardDesignRef			References to the card design
panMask	string			Masked PAN
mbr	integer			Card member number / EMV application PAN sequence number
status	string			Card status
lifePhaseRid	string			Card lifecycle phase reference ID. Card lifecycle phases are configured in the system; refer to your TranzAxis configuration to obtain the list of lifecycle phase IDs configured.
restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile
tdsEnrollment	boolean			Indicates that the card is enrolled in E-commerce 3DS service
logistics	object			Card delivery details
└─ deliveryBranchName	string			Branch where the card will be delivered to, in case the card needs to be delivered to the branch
└─ deliveryAddress	common-Address			Location address where the card will be delivered to, in case the card needs to be delivered to the particular location
└─ curBranchName	string			Branch where the card is at the moment
names	object			Names on the card
└─ emboss	string			Name to be printed/embossed on the card
└─ track	string			Name to be written on Track2 or chip
└─ print	string			Name to be printed on other media, e.g. PIN mailer, etc.
dates	object
└─ validFrom	string(date)			Date the card is valid from
└─ creation	string(date)			Date when the card was created
└─ activation	string(date)			Date when the card was activated
└─ expiration	string(date)	✔		Card expiration date in full format. Please convert it to short format as required, e.g. usually the card expiration date is presented to customers as MM/YY.
└─ closure	string(date)			Date when the card was closed
notes	string			Comment to the card
userAttrs	common-UserAttrs			User-defined attributes of the card

restriction-RestrictionProfileRef

{
  "id": 6846,
  "rid": "RPRID78"
}

References to the restriction profile

Properties

Name	Type	Required	Restrictions	Description
id	integer			Restriction profile internal ID
rid	string			Restriction profile reference ID

terminal-CashAccountingSchemeRef

{
  "id": 1746,
  "rid": "ET73"
}

Reference to the cash accounting scheme (cash profile)

Properties

Name	Type	Required	Restrictions	Description
id	integer			Internal ID
rid	string			Reference ID

application-ApplicationRef

{
  "id": 13579,
  "rid": "ARID24680",
  "key": "aadgk1357924680"
}

Unique references to the application

Properties

Name	Type	Required	Restrictions	Description
id	integer			Application internal ID
rid	string			Application reference ID
key	string			Additional unique application key that can be used to quickly search for the application

surcharge-tariff-plan

{
  "ref": {
    "id": "BHUMNF5OOJEH7AWVPAHS2OY6XYXX",
    "rid": "TP23"
  },
  "name": "Common"
}

Surcharge tariff plan

Properties

Name	Type	Required	Restrictions	Description
ref	surcharge-tariff-plan-SurchargeTariffPlanRef			Reference to the surcharge tariff plan
name	string			Tariff plan name

card-product

{
  "ref": {
    "id": 22,
    "rid": "CPRID22"
  },
  "name": "Unlimited silver",
  "cardClassName": "Smart cards",
  "parentProduct": {
    "id": 22,
    "rid": "CPRID22"
  }
}

Card Product object. Card product in TranzAxis defines common properties of cards created under the product, as well as card production features. Card product can be included in hierarchies, thus allowing to inherit and redefine parameter values, which simplifies product management and control over complicated configurations.

Properties

Name	Type	Required	Restrictions	Description
ref	card-product-CardProductRef			References to the card product
name	string			Card product name in TranzAxis
cardClassName	string			Name of the card class used for card production, e.g. "Visa Smart Debit/Credit", "MChip Advance", "JCB J/Smart", etc. These classes are predefined in the system and applied when configuring the card product in TranzAxis. Refer to the TranzAxis documentation for a complete list of classes supported.
parentProduct	card-product-CardProductRef			If the hierarchy of card products is used, contains the reference to the parent card product in the hierarchy.

contract-ContractRef

{
  "id": 4680,
  "rid": "CRID4542809",
  "extRid": "CASA1268"
}

References to the contract

Properties

Name	Type	Required	Restrictions	Description
id	integer			Contract internal ID
rid	string			Contract reference ID
extRid	string			Contract external reference ID

application-type-ApplicationTypeRef

{
  "id": 12,
  "rid": "ATRID12"
}

Unique references to the application type

Properties

Name	Type	Required	Restrictions	Description
id	integer			Application type internal ID
rid	string			Application type reference ID

subject-NetworkSpecAttrs

[
  {
    "networkName": "string",
    "toDelete": true,
    "rid": "string",
    "merchantRid": "string",
    "singleMerchantRid": "string",
    "name": "string",
    "mcc": "string"
  }
]

List of network-specific attributes

Properties

Name	Type	Required	Restrictions	Description
	[subject-NetworkSpecAttr]			List of network-specific attributes

contract2contract

{
  "id": 897592,
  "contract1": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "contract1Name": "Digital card",
  "contract2": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "contract2Name": "Revolving",
  "kind": "string",
  "status": "string",
  "seq": 1
}

Object that represents a link between contracts. Links can be used to join separate contracts into one complex product. Each contract performs its own functions and employs the linked contracts, if necessary. A contract can have multiple links to other contracts.

Properties

Name	Type	Required	Restrictions	Description
id	integer			Link ID
contract1	contract-ContractRef			Reference to contract 1 in the link
contract1Name	string			Name of contract 1
contract2	contract-ContractRef			Reference to contract 2 in the link
contract2Name	string			Name of contract 2
kind	string			Link type
status	string			Link status
seq	integer			Link sequence number in contract 1

subject-type

{
  "ref": {
    "id": 564,
    "rid": "STRID23"
  },
  "name": "Customer",
  "kind": "Person",
  "parentType": {
    "id": 564,
    "rid": "STRID23"
  }
}

\"Subject Type" object. All subjects (persons and companies) in TranzAxis belong to the specific type defined in the dictionary of subject types. A "subject type" in TranzAxis represents common features of a group of persons or companies of that type. A subject type also belongs to a certain basic class - "individual customer" (person), "corporate customer" (company), or "department".

Properties

Name	Type	Required	Restrictions	Description
ref	subject-type-SubjectTypeRef			Reference to the subject type
name	string			Subject type name
kind	subject-SubjectKind			Subject type
parentType	subject-type-SubjectTypeRef			If the hierarchy of subject types is used, contains the reference to the parent subject type in the hierarchy.

subject-document-SubjectDocumentRef

{
  "id": 8737
}

Reference to the document

Properties

Name	Type	Required	Restrictions	Description
id	integer			Document internal ID. (!) Please note that this is not a document number.

application-type

{
  "ref": {
    "id": 12,
    "rid": "ATRID12"
  },
  "name": "Credit applications",
  "isAbstract": true,
  "parentType": {
    "id": 12,
    "rid": "ATRID12"
  }
}

Application Type object. Application types can be arranged as an hierarchy of types to simplify the management of applications by using the built-in inheritance feature of TranzAxis.

Properties

Name	Type	Required	Restrictions	Description
ref	application-type-ApplicationTypeRef			Unique references to the application type
name	string			Application type name
isAbstract	boolean			Indicates whether the application type can be used to create applications of this type. true indicates that the application type is abstract and is only used to build an hierarchy of application types.
parentType	application-type-ApplicationTypeRef			If the hierarchy of application types is used, contains the reference to the parent application type in the hierarchy.

tran-TranRef

{
  "id": 7875458909934,
  "matchKey": "trnaadgk1357924680",
  "rqSentTime": "2020-10-21T14:15:00"
}

References to the transaction

Properties

Name	Type	Required	Restrictions	Description
id	integer			Transaction internal ID
matchKey	string			Transaction matching key assigned. Used in TranzAxis for transactions matching and passed in the specific field in the request body - /tranRq/match/key.
rqSentTime	string(date-time)			Date and time when the transaction request was sent to the system. The system matchs matchKey and transaction regTime within the following windowframe - rqSentTime <= regTimeand <= rqSentTime + 60s.

common-UserAttrs

[
  {
    "rid": "UDPRID3",
    "val": "VAL-1"
  }
]

Container of user-defined attributes

Properties

Name	Type	Required	Restrictions	Description
	[common-UserAttr]			Container of user-defined attributes

contract-type-TariffPlan

{
  "ref": {
    "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
    "rid": "TPRID963"
  },
  "name": "Common pricing plan"
}

Default (shared) tariff plan. "Tariff Plan" object in TranzAxis represents different pricing parameters, such as fees, charges, interest rates, etc. configured as "Tariff" records within the "Tariff Plan".

Properties

Name	Type	Required	Restrictions	Description
ref	contract-type-TariffPlanRef			Reference to the default (shared) tariff plan
name	string			Tariff plan name

card-product-CardProductRef

{
  "id": 22,
  "rid": "CPRID22"
}

References to the card product

Properties

Name	Type	Required	Restrictions	Description
id	integer			Card product ID
rid	string			Card product reference ID

card-CardRef

{
  "id": 13579,
  "rid": "CRDRID24680"
}

References to the card

Properties

Name	Type	Required	Restrictions	Description
id	integer			Card internal ID
rid	string			Card reference ID

terminal-config

{
  "ref": {
    "id": 564,
    "rid": "Ab23"
  },
  "className": "TermConfig.Tptp",
  "name": "string"
}

Terminal Configuration object

Properties

Name	Type	Required	Restrictions	Description
ref	terminal-config-TermConfigRef			Reference to the terminal configuration
className	any			Terminal configuration class name
name	string			Terminal configuration name

contract-type-TariffPlanRef

{
  "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
  "rid": "TPRID963"
}

Reference to the default (shared) tariff plan

Properties

Name	Type	Required	Restrictions	Description
guid	string			Tariff plan GUID
rid	string			Tariff plan reference ID

subject

{
  "ref": {
    "id": 1746,
    "rid": "PRID73"
  },
  "type": {
    "id": 564,
    "rid": "STRID23"
  },
  "kind": "Person",
  "details": {},
  "networkSpec": [
    {
      "networkName": "string",
      "toDelete": true,
      "rid": "string",
      "merchantRid": "string",
      "singleMerchantRid": "string",
      "name": "string",
      "mcc": "string"
    }
  ],
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Subject (person, company)

Properties

Name	Type	Required	Restrictions	Description
ref	subject-SubjectRef			References to the person/company
type	subject-type-SubjectTypeRef			Reference to the subject type
kind	subject-SubjectKind			Subject type
details	any

anyOf

Name	Type	Required	Restrictions	Description
	object			Details specific to the respective subject class

or

Name	Type	Required	Restrictions	Description
	subject_details-corporation

or

Name	Type	Required	Restrictions	Description
	subject_details-person

continued

Name	Type	Required	Restrictions	Description
networkSpec	subject-NetworkSpecAttrs			Network-specific attributes of the subject
userAttrs	common-UserAttrs			User-defined attributes of the subject

terminal-settings-TerminalSettingsRef

{
  "id": 564,
  "rid": "POS23"
}

Reference to the terminal settings

Properties

Name	Type	Required	Restrictions	Description
id	integer			Terminal settings ID
rid	string			Terminal settings reference ID

restriction

{
  "ref": {
    "guid": "7febf16f651b43b0a5e30da8da49e",
    "rid": "RRID0847"
  },
  "classGuid": "7febf16f651b43b0a5e30da8da49e90d",
  "name": "Daily usage limit",
  "inUse": true,
  "begTime": "2020-10-21T14:15:00",
  "endTime": "2020-10-22T14:15:00",
  "tmpOff": {
    "begTime": "2020-11-21T14:15:00",
    "endTime": "2020-11-22T14:15:00"
  },
  "maxVal": 10,
  "ccy": "USD",
  "tmpMax": {
    "val": 20,
    "begTime": "2020-10-21T14:15:00",
    "endTime": "2020-10-22T14:15:00"
  },
  "limit": {
    "reset": {
      "periodType": "string",
      "timeOffset": 1440
    },
    "windowSize": 30,
    "curVal": 3,
    "lastResetTime": "2020-10-21T14:15:00"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Restriction object. Restriction object in TranzAxis represents different limits, counters and other restrictions that can be applied to cards (tokens), accounts (contracts), customers (subjects) and terminals to control operations, e.g. velocity limits, permitted transaction types, etc. Restrictions are combined into restriction/risk profiles that comprise limitations of the same category, e.g. "contract restriction profile" is applied to contracts, "card/token risk profile" is applied to cards, etc.

Properties

Name	Type	Required	Restrictions	Description
ref	restriction-RestrictionRef			References to the restriction/limit
classGuid	string			Unique restriction class identifier
name	string			Restriction name (description)
inUse	boolean			Indicates that the restriction is active. true indicates that the restriction is currently in use.
begTime	string(date-time)			Restriction effective from
endTime	string(date-time)			Restriction effective to
tmpOff	object			Indicates that the restriction is temporarily disabled (during the usage period)
└─ begTime	string(date-time)			Restriction inactive from
└─ endTime	string(date-time)			Restriction inactive to
maxVal	number			Maximum restriction value. For restrictions of the "limit" type, it is the maximum accumulated value; for other types of restrictions, it is the maximum value of the transaction.
ccy	string			Restriction currency (alpha3 currency code)
tmpMax	object			Parameters of the temporary maximum value
└─ val	number			Temporary maximum value
└─ begTime	string(date-time)			Temporary maximum value effective from
└─ endTime	string(date-time)			Temporary maximum value effective to
limit	object			Limit parameters (applicable to restrictions of the "limit" type)
└─ reset	object			Limit reset parameters
‎‎ ‎ └─ periodType	string			Limit reset period
‎‎ ‎ └─ timeOffset	integer			Reset time offset. Defined as the number of minutes after the period start.
└─ windowSize	integer			Accumulation window. Defines how many periods will be used during accumulation.
└─ curVal	number			Currently accumulated value
└─ lastResetTime	string(date-time)			Date/time when the limit was last reset
userAttrs	common-UserAttrs			User-defined attributes

tran-SrcCard

{
  "pan": 7645346863537866000,
  "expDate": "2027-10-21",
  "cvv2": 222,
  "tds": {
    "version": 2.1,
    "networkType": "string",
    "eci": 5,
    "condition": "string",
    "cavv": 5,
    "dsTranId": 7976543639,
    "xid": "SGVsbG8sIFdvcmxkIQ"
  }
}

Source card details

Properties

Name	Type	Required	Restrictions	Description
pan	string	✔		Card PAN
expDate	string(date)	✔		Card expiration date
cvv2	string			Card CVV2
tds	object			E-commerce 3-D Secure details
└─ version	string			3-D Secure (3DS) version, e.g. 1.0, 2.2, etc.
└─ networkType	string			Network type
└─ eci	string			Network-related E-commerce indicator
└─ condition	string			3DS authentication conditions
└─ cavv	string			3DS cardholder authentication verification value (CAVV)
└─ dsTranId	string			Transaction ID from the Directory Server
└─ xid	string			3DS XID parameter

common-TranRqExtraAttrs

{
  "clerkName": "Operator_1",
  "intMess": 7,
  "textMess": "TTY=8872;SHIF-6839;",
  "categoryCode": "TCC3",
  "categoryText": "Unhandled",
  "classification": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "match": {
    "key": "adgjl1357guid",
    "rrn": "RN6538303344"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Additional specific parameters that can be passed to the TranzAxis internal RTP transaction (for details, refer to the TranzAxis RTP specification)

Properties

Name	Type	Required	Restrictions	Description
clerkName	string			Operator name
intMess	integer			Message ID
textMess	string			Text message container
categoryCode	string			Transaction category code
categoryText	string			Transaction category name
classification	common-UserAttrs			Transaction user-defined classifiers, as populated by the system and returned in the form of user-defined attributes
match	common-TranMatch			Transaction matching properties
userAttrs	common-UserAttrs			Additional user-defined attributes configured for the transaction in the system

contract-type-ContractTypeRef

{
  "id": 97548,
  "rid": "CTRID975"
}

References to the contract type

Properties

Name	Type	Required	Restrictions	Description
id	integer			Contract type ID
rid	string			Contract type reference ID

terminal

{
  "ref": {
    "id": 1746,
    "rid": "T73",
    "extRid": "ET73"
  },
  "name": "string",
  "title": "string",
  "className": "string",
  "type": "string",
  "status": "string",
  "branch": {
    "id": 1746,
    "rid": "B3",
    "code": "BB2"
  },
  "merchantServiceContract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "settings": {
    "id": 564,
    "rid": "POS23"
  },
  "config": {
    "id": 564,
    "rid": "Ab23"
  },
  "cashAccountingSchemeRid": {
    "id": 1746,
    "rid": "ET73"
  },
  "surchargeTariffPlan": {
    "id": "BHUMNF5OOJEH7AWVPAHS2OY6XYXX",
    "rid": "TP23"
  },
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "mcc": 5942,
  "defaultCurrency": "USD",
  "defaultLanguage": "string",
  "timeZone": "UTC",
  "address": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "keys": {
    "pmk": {
      "id": 1746
    },
    "pwk": {
      "id": 1746
    },
    "mmk": {
      "id": 1746
    },
    "mwk": {
      "id": 1746
    },
    "emk": {
      "id": 1746
    },
    "ewk": {
      "id": 1746
    },
    "rkl": {
      "id": 1746
    }
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Terminal

Properties

Name	Type	Required	Restrictions	Description
ref	terminal-TerminalRef			References to the terminal
name	string			TID
title	string
className	string			classGuid
type	string
status	string
branch	common-BranchRef			Reference to the branch
merchantServiceContract	contract-ContractRef			References to the contract
settings	terminal-settings-TerminalSettingsRef			Reference to the terminal settings
config	terminal-config-TermConfigRef			Reference to the terminal configuration
cashAccountingSchemeRid	terminal-CashAccountingSchemeRef			Cash accounting scheme (cash profile)
surchargeTariffPlan	surcharge-tariff-plan-SurchargeTariffPlanRef			Reference to the surcharge tariff plan
restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile
mcc	integer			Merchant category code
defaultCurrency	string			Default terminal currency (alpha3 code)
defaultLanguage	string			Default terminal language (alpha2 code)
timeZone	string			Terminal location time zone
address	common-Address			Address and contact details
keys	object			Terminal keys
└─ pmk	common-CryptoKeyRef			PIN master key
└─ pwk	common-CryptoKeyRef			PIN working key
└─ mmk	common-CryptoKeyRef			MAC master key
└─ mwk	common-CryptoKeyRef			MAC working key
└─ emk	common-CryptoKeyRef			Encryption master key
└─ ewk	common-CryptoKeyRef			Encryption working key
└─ rkl	common-CryptoKeyRef			Remote key loading key
userAttrs	common-UserAttrs			User-defined attributes of the terminal

tran-Vendor

{
  "rid": "SPRID865439"
}

Reference to the service provider (payments)

Properties

Name	Type	Required	Restrictions	Description
rid	string	✔		Service provider reference ID (payee contract RID)

card-design-CardDesignRef

{
  "id": 12,
  "rid": "DESRID12"
}

References to the card design

Properties

Name	Type	Required	Restrictions	Description
id	integer			Card design internal ID
rid	string			Card design reference ID

common-ModifyTranApproveRs

{
  "tranId": 1357924680,
  "approvalCode": "A200567",
  "objectId": 77365
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	common-TranApproveRs			Response for approved transaction

and

Name	Type	Required	Restrictions	Description
	object			Response for approved object modification transaction
└─ objectId	integer			Internal object ID in the system

card-design

{
  "ref": {
    "id": 12,
    "rid": "DESRID12"
  },
  "name": "Plain"
}

Card Design object

Properties

Name	Type	Required	Restrictions	Description
ref	card-design-CardDesignRef			References to the card design
name	string			Card design name in TranzAxis

restriction-RestrictionRef

{
  "guid": "7febf16f651b43b0a5e30da8da49e",
  "rid": "RRID0847"
}

References to the restriction/limit

Properties

Name	Type	Required	Restrictions	Description
guid	string			Restriction internal ID
rid	string			Restriction reference ID

subject-SubjectKind

"Person"

Subject type

Properties

Name	Type	Required	Restrictions	Description
	string			Subject type

Enumerated Values

Property	Value
	Person
	Corporation

common-MonetaryValue

{
  "amt": 20,
  "ccy": "USD"
}

Amount and currency

Properties

Name	Type	Required	Restrictions	Description
amt	number			Amount
ccy	string			Alpha3 currency code

notification-type

{
  "ref": {
    "id": 87648,
    "rid": "NTRID878"
  },
  "name": "OTP",
  "className": "Base Notifications",
  "parentType": {
    "id": 87648,
    "rid": "NTRID878"
  }
}

Notification Type object

Properties

Name	Type	Required	Restrictions	Description
ref	notification-type-NotificationTypeRef			References to the notification type
name	string			Notification type name
className	string			Notification type class (=Notification Contract Type)
parentType	notification-type-NotificationTypeRef			If the hierarchy of notification types is used, contains the reference to the parent notification type in the hierarchy

contract

{
  "ref": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  },
  "className": "Contract.Shadow",
  "type": {
    "id": 97548,
    "rid": "CTRID975"
  },
  "client": {
    "id": 1746,
    "rid": "PRID73"
  },
  "details": {},
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Contract object. Contract in TranzAxis represents common terms and conditions of a product and it is used in the system to power different services, such as card production ("issuing contract"), operations processing ("financial contract"), customer notifications, etc.

Properties

Name	Type	Required	Restrictions	Description
ref	contract-ContractRef			References to the contract
className	string			Contract class
type	contract-type-ContractTypeRef			References to the contract type
client	subject-SubjectRef			References to the person/company
details	any

anyOf

Name	Type	Required	Restrictions	Description
	object			Details specific to the respective contract class

or

Name	Type	Required	Restrictions	Description
	contract_details-notify

or

Name	Type	Required	Restrictions	Description
	contract_details-merchant-service

or

Name	Type	Required	Restrictions	Description
	contract_details-merchant-settlement

or

Name	Type	Required	Restrictions	Description
	contract_details-trch_rvl_credit

or

Name	Type	Required	Restrictions	Description
	contract_details-shadow

continued

Name	Type	Required	Restrictions	Description
userAttrs	common-UserAttrs			User-defined attributes of the contract

terminal-TerminalRef

{
  "id": 1746,
  "rid": "T73",
  "extRid": "ET73"
}

References to the terminal

Properties

Name	Type	Required	Restrictions	Description
id	integer			Internal ID
rid	string			Reference ID
extRid	string			External reference ID

common-TranDeclineRs

{
  "tranId": 1357924680,
  "result": "string",
  "code": 888,
  "description": "Not available"
}

Response for declined transaction

Properties

Name	Type	Required	Restrictions	Description
tranId	integer			Unique transaction ID in the system
result	string			Transaction decline result
code	string			Decline reason code
description	string			Decline reason text

terminal-config-TermConfigRef

{
  "id": 564,
  "rid": "Ab23"
}

Reference to the terminal configuration

Properties

Name	Type	Required	Restrictions	Description
id	integer			Terminal configuration ID
rid	string			Terminal configuration reference ID

contract-type

{
  "ref": {
    "id": 97548,
    "rid": "CTRID975"
  },
  "name": "Revolving credit",
  "contractClassName": "Credit contracts",
  "isAbstract": true,
  "parentType": {
    "id": 97548,
    "rid": "CTRID975"
  },
  "tariffPlans": [
    {
      "ref": {
        "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
        "rid": "TPRID963"
      },
      "name": "Common pricing plan"
    }
  ]
}

Contract Type object. Contract type in TranzAxis represents common features, rules and functions of a business product or service. Contract type should not be confused with the "contract class", which is a more generic definition of a business product. Contract type can be included in hierarchies, thus allowing to inherit and redefine parameter values, which simplifies product management and control over complicated configurations.

Properties

Name	Type	Required	Restrictions	Description
ref	contract-type-ContractTypeRef			References to the contract type
name	string			Contract type name
contractClassName	string			Contract class name
isAbstract	boolean			Indicates whether the contract type can be used to create contracts of this type. true indicates that the contract type is abstract and is only used to build a hierarchy of contract types.
parentType	contract-type-ContractTypeRef			If the hierarchy of contract types is used, contains the reference to the parent contract type in the hierarchy.
tariffPlans	[contract-type-TariffPlan]			Default pricing parameters (tariff plans) for the business product used by all contracts of this type

tran-InstallmentRq

{
  "byMerchant": {
    "typeId": 135,
    "trancheCnt": 5,
    "initialAmt": 237
  },
  "byIssuer": {
    "planId": "CRID245",
    "trancheCnt": 6
  }
}

Parameters related to the installment management request

Properties

Name	Type	Required	Restrictions	Description
byMerchant	object			Installment funded by the merchant
└─ typeId	integer			Installment-related contract type ID in TranzAxis
└─ trancheCnt	integer			Number of installments (without initial payment)
└─ initialAmt	number			Minimum initial payment amount in transaction currency
byIssuer	object			Installment funded by the issuer or financial institution
└─ planId	string			Installment plan ID as installment-related contract type RID in TranzAxis
└─ trancheCnt	integer			Number of installments

surcharge-tariff-plan-SurchargeTariffPlanRef

{
  "id": "BHUMNF5OOJEH7AWVPAHS2OY6XYXX",
  "rid": "TP23"
}

Reference to the surcharge tariff plan

Properties

Name	Type	Required	Restrictions	Description
id	string			Tariff plan ID
rid	string			Tariff plan reference ID

contract_details-merchant-settlement

{
  "status": "string",
  "name": "Contract 1",
  "dates": {
    "creation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "activation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "finish": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "closure": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    }
  },
  "usageRestriction": null,
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "sharedTariffPlan": {
    "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
    "rid": "TPRID963"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			Merchant settlement contract details

common-UserAttr

{
  "rid": "UDPRID3",
  "val": "VAL-1"
}

User-defined attribute

Properties

Name	Type	Required	Restrictions	Description
rid	string			Reference ID
val	string			Value

contract_details-notify

{
  "status": "string",
  "name": "Contract 1",
  "dates": {
    "creation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "activation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "finish": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "closure": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    }
  },
  "usageRestriction": null,
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "sharedTariffPlan": {
    "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
    "rid": "TPRID963"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "subscriptions": [
    {
      "id": 13579,
      "type": {
        "id": 87648,
        "rid": "NTRID878"
      },
      "status": "string",
      "allowedAddressesIds": [
        0
      ],
      "begSendTime": 420,
      "endSendTime": 1200,
      "options": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ],
  "addresses": [
    {
      "id": 46803,
      "isActive": true,
      "channelKind": "string",
      "address": "abnet@mail.net",
      "deviceName": "XCID765369"
    }
  ]
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			Notification contract details. Notification contract describes how the system notifies customers of transactions, events, etc. The customer should have an active notification subscription, which is part of the notification contract. Subscription has different parameters to control and manage respective notifications.
└─ subscriptions	[object]			List of notification subscriptions
‎‎ ‎ └─ id	integer			Subscription ID
‎‎ ‎ └─ type	notification-type-NotificationTypeRef			References to the notification type
‎‎ ‎ └─ status	string			Subscription status
‎‎ ‎ └─ allowedAddressesIds	[integer]			IDs of permitted delivery addresses. null indicates that all addresses are permitted.
‎‎ ‎ └─ begSendTime	integer			System will not send notifications before this time (defined as the number of minutes after 00:00). For example, 420 means that the system will not send notifications before 7 AM (7*60).
‎‎ ‎ └─ endSendTime	integer			System will not send notifications after this time (defined as the number of minutes after 00:00). For example, 1200 means that the system will not send notifications after 8 PM (20*60).
‎‎ ‎ └─ options	common-UserAttrs			Subscription options configured in TranzAxis (as user-defined attributes)
└─ addresses	[object]			Notification delivery channel details
‎‎ ‎ └─ id	integer			Channel ID
‎‎ ‎ └─ isActive	boolean			Channel status. true means that the channel is active.
‎‎ ‎ └─ channelKind	string			Channel type
‎‎ ‎ └─ address	string			Notification delivery address, e.g. phone number, email, etc. For push notifications, contains the application address. null means that the customer contact information is used.
‎‎ ‎ └─ deviceName	string			Device name used for push notifications

subject_details-corporation

{
  "mailAddress": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "languageCode": "EN",
  "locale": "en-US",
  "status": "string",
  "notificationContractId": 3987,
  "documents": [
    {
      "ref": {
        "id": 8737
      },
      "type": {
        "id": 56,
        "rid": "DTRID084"
      },
      "series": 7522,
      "country": 0,
      "regionRid": "string",
      "rid": 888122,
      "issuerName": "Regional security office",
      "issuerId": 2,
      "issuerRid": "Rid",
      "isActive": true,
      "issueDate": "2020-10-21",
      "expDate": "2035-10-21",
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ],
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "parent": {
    "id": 1746,
    "rid": "PRID73"
  },
  "name": "Strong Club",
  "shortName": "S-Club",
  "legalName": "Strong Club Ltd.",
  "latName": "string",
  "address": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "legalAddress": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "mcc": 5942
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	subject_details			Common properties of subjects of any type

and

Name	Type	Required	Restrictions	Description
	object			Company or corporate customer details
└─ parent	subject-SubjectRef			If the hierarchy of companies is used, contains the reference to the parent company in the hierarchy.
└─ name	string			Full name of the company
└─ shortName	string			Short name of the company
└─ legalName	string			Legal name of the company
└─ latName	string			Company name in latin
└─ address	common-Address			Company contact address
└─ legalAddress	common-Address			Company legal address
└─ mailAddress	common-Address			Company mailing address
└─ mcc	integer			Merchant category code

subject_details-person

{
  "mailAddress": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "languageCode": "EN",
  "locale": "en-US",
  "status": "string",
  "notificationContractId": 3987,
  "documents": [
    {
      "ref": {
        "id": 8737
      },
      "type": {
        "id": 56,
        "rid": "DTRID084"
      },
      "series": 7522,
      "country": 0,
      "regionRid": "string",
      "rid": 888122,
      "issuerName": "Regional security office",
      "issuerId": 2,
      "issuerRid": "Rid",
      "isActive": true,
      "issueDate": "2020-10-21",
      "expDate": "2035-10-21",
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ],
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "lastName": "Doe",
  "firstName": "John",
  "middleName": "V.",
  "birthDate": "2000-10-21",
  "gender": "string",
  "residenceCountry": 840,
  "citizenshipCountry": 840,
  "extraCitizenships": [
    [
      826,
      840
    ]
  ],
  "regAddress": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "homeAddress": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "emails": [
    "go21@mail.net"
  ],
  "phones": [
    1217077304
  ],
  "workPhones": [
    18938077304
  ],
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  }
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	subject_details			Common properties of subjects of any type

and

Name	Type	Required	Restrictions	Description
	object			Person or individual customer details
└─ lastName	string			Last name
└─ firstName	string			First name
└─ middleName	string			Middle name (if applicable)
└─ birthDate	string(date)			Birthdate
└─ gender	string
└─ residenceCountry	integer			Country of residence (ISO numeric code)
└─ citizenshipCountry	integer			Country of citizenship, main (ISO numeric code)
└─ extraCitizenships	[integer]			Countries of citizenship, others (ISO numeric code)
└─ regAddress	common-Address			Registration address
└─ homeAddress	common-Address			Residential address
└─ emails	[string]			List of emails
└─ phones	[string]			List of contact phone numbers
└─ workPhones	[string]			List of office phone numbers
└─ restrictionsProfile	restriction-RestrictionProfileRef			References to the restriction profile

common-TranMatch

{
  "key": "adgjl1357guid",
  "rrn": "RN6538303344"
}

Transaction matching properties

Properties

Name	Type	Required	Restrictions	Description
key	string			Represents a unique key for the operation (transaction). This key is assigned to the operation once it is processed successfully (e.g. the object is updated successfully). If the operation result is unknown for any reason, you can just repeat the same request with the same "key". If the transaction is not found in the system, it will be processed as expected, otherwise the system will respond that the transaction has already been processed and no changes will be introduced.
rrn	string			Retrieval request number. Used as a transaction reference value in some scenarios, e.g. when processing reversals, etc.

common-BranchRef

{
  "id": 1746,
  "rid": "B3",
  "code": "BB2"
}

Reference to the branch

Properties

Name	Type	Required	Restrictions	Description
id	integer			Internal ID
rid	string			Reference ID
code	string			Code

common-CryptoKeyRef

{
  "id": 1746
}

Reference to the crypto key

Properties

Name	Type	Required	Restrictions	Description
id	integer			Internal ID

contract_details-shadow

{
  "status": "string",
  "name": "Contract 1",
  "dates": {
    "creation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "activation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "finish": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "closure": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    }
  },
  "usageRestriction": null,
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "sharedTariffPlan": {
    "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
    "rid": "TPRID963"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "mainCcy": "USD",
  "permOverdraft": 1000,
  "tmpOverdraft": 0,
  "tmpOverdraftExpiration": "2027-10-21T14:15:00",
  "balances": {
    "available": 5000,
    "ledger": 5200,
    "financial": 5000,
    "curCreditHolds": 200,
    "curDebitHold": 100,
    "permittedOverdraft": 500,
    "debt": 300
  }
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			\"Shadow" contract details. "Shadow" contract represents the case with the current account when another system (e.g. Core Banking System) manages the actual account balance while TranzAxis only manages cards and stores common account properties. Usually, such scenario requires an online integration with the account management system to authorize operations and change the balance.
└─ mainCcy	string			Contract currency (alpha3 currency code). For multi-currency contracts, it is the main currency of the contract.
└─ permOverdraft	number			Overdraft amount (if permitted)
└─ tmpOverdraft	number			Temporary overdraft amount (if permitted)
└─ tmpOverdraftExpiration	string(date-time)			Temporary overdraft expiration date and time (if permitted)
└─ balances	object			Account balances
‎‎ ‎ └─ available	number			Available balance (account balance – debit holds)
‎‎ ‎ └─ ledger	number			Lenger balance (account balance + credit holds)
‎‎ ‎ └─ financial	number			Account balance
‎‎ ‎ └─ curCreditHolds	number			Total amount of credit holds
‎‎ ‎ └─ curDebitHold	number			Total amount of debit holds
‎‎ ‎ └─ permittedOverdraft	number			Available overdraft amount (if applicable)
‎‎ ‎ └─ debt	number			Total debt amount (if applicable)

subject-document-type-SubjectDocumentTypeRef

{
  "id": 56,
  "rid": "DTRID084"
}

Reference to the document type

Properties

Name	Type	Required	Restrictions	Description
id	integer			Document type ID
rid	string			Document type reference ID

common-Address

{
  "zip": "NG71AE",
  "country": 0,
  "region": "CAL",
  "regionRid": "string",
  "area": "Nord",
  "areaRid": "string",
  "city": "Homeburg",
  "cityRid": "string",
  "street": "Broadway",
  "streetRid": "string",
  "house": 15,
  "building": 2,
  "construction": 1,
  "flat": 4,
  "addressInCity": null,
  "addressInCountry": null,
  "recipientName": "Robert Smith",
  "phone": 976356838473,
  "fax": null,
  "mobile": 976356838473,
  "email": "r.smith@mymail.net",
  "url": null
}

Address and contact details

Properties

Name	Type	Required	Restrictions	Description
zip	string
country	integer			ISO numeric code
region	string
regionRid	string			RID in the address database
area	string
areaRid	string			RID in the address database
city	string
cityRid	string			RID in the address database
street	string
streetRid	string			RID in the address database
house	string
building	string
construction	string
flat	string
addressInCity	string
addressInCountry	string
recipientName	string
phone	string
fax	string
mobile	string
email	string
url	string

contract_details-merchant-service

{
  "status": "string",
  "name": "Contract 1",
  "dates": {
    "creation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "activation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "finish": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "closure": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    }
  },
  "usageRestriction": null,
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "sharedTariffPlan": {
    "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
    "rid": "TPRID963"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "settlementContract": {
    "id": 4680,
    "rid": "CRID4542809",
    "extRid": "CASA1268"
  }
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			Merchant service contract details
└─ settlementContract	contract-ContractRef			References to the contract

contract_details-trch_rvl_credit

{
  "status": "string",
  "name": "Contract 1",
  "dates": {
    "creation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "activation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "finish": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "closure": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    }
  },
  "usageRestriction": null,
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "sharedTariffPlan": {
    "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
    "rid": "TPRID963"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ],
  "mainCcy": "USD",
  "cclBaseAmt": 3000,
  "cclTmpAmt": 1000,
  "cclTmpPeriodBeg": "2020-10-21T14:15:00",
  "cclTmpPeriodEnd": "2021-10-21T14:15:00",
  "balances": {
    "available": 3000,
    "ownAvailable": 1000,
    "ledger": 2000,
    "financial": 3000,
    "curCreditHolds": 1000,
    "curDebitHold": 300,
    "debt": 1500,
    "creditLimit": 1500
  }
}

Properties

allOf

Name	Type	Required	Restrictions	Description
	contract_details			Common properties of contracts of any class

and

Name	Type	Required	Restrictions	Description
	object			Additional details of the revolving credit contract
└─ mainCcy	string			Contract currency (alpha3 currency code). For multi-currency contracts, it is the main currency of the contract.
└─ cclBaseAmt	number			Contract credit limit. This is the common base value of the maximum credit amount. Some credit contracts can also have other special credit limits, e.g. for debt categories. Please refer to the configuration of credit contracts in TranzAxis for more detials.
└─ cclTmpAmt	number			Temporary credit limit. Once set, it is effective during the specified period and replaces the base credit limit.
└─ cclTmpPeriodBeg	string(date-time)			Temporary credit limit effective from
└─ cclTmpPeriodEnd	string(date-time)			Temporary credit limit effective to
└─ balances	object			Contract balances
‎‎ ‎ └─ available	number			Available balance (account balance – debit holds/used credit + own funds)
‎‎ ‎ └─ ownAvailable	number			Available balance of own funds (if applicable). Some credit contracts permit customers to have own funds on the balance.
‎‎ ‎ └─ ledger	number			Lenger balance (account balance + credit holds)
‎‎ ‎ └─ financial	number			Account balance
‎‎ ‎ └─ curCreditHolds	number			Total amount of credit holds
‎‎ ‎ └─ curDebitHold	number			Total amount of debit holds
‎‎ ‎ └─ debt	number			Total debt amount
‎‎ ‎ └─ creditLimit	number			Current credit limit. This balance represents the current effective credit limit value with regard to the active temporary limit and current contract restrictions.

contract_details-TimeAndBusinessDay

{
  "time": "2020-10-21T14:15:00",
  "businessDay": "2020-10-21"
}

Properties

Name	Type	Required	Restrictions	Description
time	string(date-time)			System time
businessDay	string(date)			Business day

subject_details

{
  "mailAddress": {
    "zip": "NG71AE",
    "country": 0,
    "region": "CAL",
    "regionRid": "string",
    "area": "Nord",
    "areaRid": "string",
    "city": "Homeburg",
    "cityRid": "string",
    "street": "Broadway",
    "streetRid": "string",
    "house": 15,
    "building": 2,
    "construction": 1,
    "flat": 4,
    "addressInCity": null,
    "addressInCountry": null,
    "recipientName": "Robert Smith",
    "phone": 976356838473,
    "fax": null,
    "mobile": 976356838473,
    "email": "r.smith@mymail.net",
    "url": null
  },
  "languageCode": "EN",
  "locale": "en-US",
  "status": "string",
  "notificationContractId": 3987,
  "documents": [
    {
      "ref": {
        "id": 8737
      },
      "type": {
        "id": 56,
        "rid": "DTRID084"
      },
      "series": 7522,
      "country": 0,
      "regionRid": "string",
      "rid": 888122,
      "issuerName": "Regional security office",
      "issuerId": 2,
      "issuerRid": "Rid",
      "isActive": true,
      "issueDate": "2020-10-21",
      "expDate": "2035-10-21",
      "userAttrs": [
        {
          "rid": "UDPRID3",
          "val": "VAL-1"
        }
      ]
    }
  ],
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Common properties of subjects of any type

Properties

Name	Type	Required	Restrictions	Description
mailAddress	common-Address			Contact address
languageCode	string			Contact language (ISO alpha-2 language code)
locale	string			Communication locale (IETF language tag)
status	string			Person/company status in TranzAxis
notificationContractId	integer			If the person/company has active notification subscriptions - internal ID of the currently active notification contract (also refer to the "contract" object for more details)
documents	[subject-document]			Subject document container
userAttrs	common-UserAttrs			Container of user-defined attributes

contract_details

{
  "status": "string",
  "name": "Contract 1",
  "dates": {
    "creation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "activation": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "finish": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    },
    "closure": {
      "time": "2020-10-21T14:15:00",
      "businessDay": "2020-10-21"
    }
  },
  "usageRestriction": null,
  "restrictionsProfile": {
    "id": 6846,
    "rid": "RPRID78"
  },
  "sharedTariffPlan": {
    "guid": "NPW63LQE2BFWPAQBET4DQIDYNY",
    "rid": "TPRID963"
  },
  "userAttrs": [
    {
      "rid": "UDPRID3",
      "val": "VAL-1"
    }
  ]
}

Common properties of contracts of any class

Properties

Name	Type	Required	Restrictions	Description
status	string			Contract status
name	string			Contract name
dates	object
└─ creation	contract_details-TimeAndBusinessDay			Date when the contract was created
└─ activation	contract_details-TimeAndBusinessDay			Date when the contract was activated
└─ finish	contract_details-TimeAndBusinessDay			Date when the contract was prepared for closure
└─ closure	contract_details-TimeAndBusinessDay			Date when the contract was closed
usageRestriction	any			Usage restriction applied to the contract, e.g. due to delinquency state, etc.
restrictionsProfile	restriction-RestrictionProfileRef			Reference to the contract restriction profile
sharedTariffPlan	contract-type-TariffPlanRef			Reference to the common (shared) pricing (tariff plan). The shared tariff plan is defined in the contract type and applicable to all contracts of this type, by default, if individual pricing is not applied to the contract.
userAttrs	common-UserAttrs			User-defined attributes