EMV Test
PaymentGateway/EMV/Authorization
Authorize a payment via a Payment Express HIT, TriPOSCloud, or Adyen device.
Http Verb POST
Resource URL https://ts-stg-appgw.calacademy.org/TessituraService/PaymentGateway/EMV/Authorization

URI Parameters

This resource has no URI (Query) parameters.

Request Body

Request object type : EMVAuthorizationRequest

Request object type EMVAuthorizationRequest has the following properties.
Property Name Data Type Length Required Readonly Notes
Amount decimal number Y Amount to authorize. Use a positive amount to indicate a purchase, and a negative amount to indicate a refund.
BillingAddress BillingAddress N Used for Address Verification System (AVS). Do not pass without also passing ConstituentId
ConstituentId integer N If not passing ConstituentId, do not pass BillingAddress
FK: T_CUSTOMER.customer_no   Resource: Constituents
IsMoto boolean Y Set to true if the EMV device requires MOTO mode to be triggered via an API call
MachineId integer Y The machine Id to use to look up EMV settings and configuration for this request.
PaymentId integer Y Should match value obtained for T_PAYMENT.payment_no. Reserve a new payment_no first and use it here.
FK: T_PAYMENT.payment_no   Resource: Payments
StoreAccount boolean N If supplied, controls whether or not the account will be stored in T_ACCOUNT_DATA after completion of the authorization, as long as the system-wide default CC_STORE_ACCOUNT is not set to No.
TransactionOrigin string Y Text indicating the origin of the transaction. The text will be written to T_PAYMENT_GATEWAY_ACTIVITY.origin if payment card tokenization is enabled.
UserData string N User-generated free-form text stored in T_PAYMENT_GATEWAY_ACTIVITY.user_data. Tessitura-generated transactions write the invoice, order, or contribution number. 
{
  "Amount": 1.0,
  "PaymentId": 2,
  "ConstituentId": 1,
  "BillingAddress": {
    "PostalCode": "sample string 1",
    "Street1": "sample string 2",
    "AddressId": 1,
    "Country": "sample string 3"
  },
  "TransactionOrigin": "sample string 3",
  "UserData": "sample string 4",
  "StoreAccount": true,
  "MachineId": 5,
  "IsMoto": true
}
<EMVAuthorizationRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Tessitura.Service.Client.PaymentGateway">
  <Amount>1</Amount>
  <BillingAddress>
    <AddressId xmlns="">1</AddressId>
    <Country xmlns="">sample string 3</Country>
    <PostalCode xmlns="">sample string 1</PostalCode>
    <Street1 xmlns="">sample string 2</Street1>
  </BillingAddress>
  <ConstituentId>1</ConstituentId>
  <IsMoto>true</IsMoto>
  <MachineId>5</MachineId>
  <PaymentId>2</PaymentId>
  <StoreAccount>true</StoreAccount>
  <TransactionOrigin>sample string 3</TransactionOrigin>
  <UserData>sample string 4</UserData>
</EMVAuthorizationRequest>

Response object type : EMVAuthorizationResponse

Response object type EMVAuthorizationResponse has the following properties.
Property Name Data Type Length Required Readonly Notes
AuthorizationResponse AuthorizationResponse
EMVStatus EMVStatus 
{
  "AuthorizationResponse": {
    "ResponseCode": "sample string 1",
    "ResponseMessage": "sample string 2",
    "AuthorizationCode": "sample string 3",
    "ReferenceNumber": "sample string 4",
    "AccountId": 5,
    "CVVResponseCode": "sample string 6",
    "AVSResponseCode": "sample string 7",
    "Succeeded": true,
    "IsPartialAuth": true,
    "AuthorizedAmount": 10.0,
    "BalanceAmount": 11.0,
    "BalanceCurrencyCode": "sample string 12",
    "PaymentMethod": {
      "AccountType": {
        "Id": 1,
        "Description": "sample string 1",
        "CardPrefix": "sample string 2",
        "CardtypeIndicator": "sample string 3",
        "EditMask": "sample string 4",
        "Inactive": true
      },
      "AuthIndicator": true,
      "BusinessUnitId": 2,
      "RequireCheckIndicator": true,
      "CreatedDateTime": "2025-04-24T04:50:35.5866205-07:00",
      "CreateLocation": "sample string 4",
      "CreatedBy": "sample string 5",
      "CurrencyTypeId": 1,
      "DefaultIndicator": true,
      "Description": "sample string 7",
      "GiftAidIndicator": true,
      "Id": 1,
      "Inactive": true,
      "Income": true,
      "CanRefund": true,
      "UpdatedDateTime": "2025-04-24T04:50:35.5866205-07:00",
      "UpdatedBy": "sample string 12",
      "NoCopiesOnAuth": 1,
      "NoCopiesOnSave": 1,
      "PaymentMethodGroup": {
        "Id": 1,
        "Description": "sample string 1",
        "Inactive": true,
        "MerchantId": "sample string 3"
      },
      "PaymentType": {
        "Id": 1,
        "Description": "sample string 1"
      },
      "ReceiptFormatId": 1,
      "RequirePostalCode": "sample string 13",
      "ShortDesc": "sample string 14",
      "StoreTenderedAmount": true,
      "OpenCashDrawer": true,
      "RequireCvv": true,
      "UseWithCardReader": true,
      "GlAccountId": "sample string 19",
      "MerchantId": "sample string 20",
      "MerchantIdForSwipe": "sample string 21",
      "ControlGroup": {
        "Description": "sample string 1",
        "Id": 2,
        "Inactive": true
      }
    },
    "TessituraMerchantServicesAction": "sample string 13",
    "ShopperIp": "sample string 14",
    "MaskedCardNumber": "sample string 15"
  },
  "EMVStatus": {
    "Status": "sample string 1",
    "CardMnemonic": "sample string 2",
    "SignatureRequired": true,
    "AccountNumber": "sample string 4",
    "CardHolderName": "sample string 5",
    "DpsTxnRef": "sample string 6",
    "AuthCode": "sample string 7",
    "Succeeded": true,
    "AccountId": 9,
    "PaymentId": 10
  }
}
<EMVAuthorizationResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <AuthorizationResponse>
    <AVSResponseCode>sample string 7</AVSResponseCode>
    <AccountId>5</AccountId>
    <AuthorizationCode>sample string 3</AuthorizationCode>
    <AuthorizedAmount>10</AuthorizedAmount>
    <BalanceAmount>11</BalanceAmount>
    <BalanceCurrencyCode>sample string 12</BalanceCurrencyCode>
    <CVVResponseCode>sample string 6</CVVResponseCode>
    <IsPartialAuth>true</IsPartialAuth>
    <MaskedCardNumber>sample string 15</MaskedCardNumber>
    <PaymentMethod>
      <AccountType>
        <CardPrefix>sample string 2</CardPrefix>
        <CardtypeIndicator>sample string 3</CardtypeIndicator>
        <Description>sample string 1</Description>
        <EditMask>sample string 4</EditMask>
        <Id>1</Id>
        <Inactive>true</Inactive>
      </AccountType>
      <AuthIndicator>true</AuthIndicator>
      <BusinessUnitId>2</BusinessUnitId>
      <CanRefund>true</CanRefund>
      <ControlGroup>
        <Description>sample string 1</Description>
        <Id>2</Id>
        <Inactive>true</Inactive>
      </ControlGroup>
      <CreateLocation>sample string 4</CreateLocation>
      <CreatedBy>sample string 5</CreatedBy>
      <CreatedDateTime>2025-04-24T04:50:35.5866205-07:00</CreatedDateTime>
      <CurrencyTypeId>1</CurrencyTypeId>
      <DefaultIndicator>true</DefaultIndicator>
      <Description>sample string 7</Description>
      <GiftAidIndicator>true</GiftAidIndicator>
      <GlAccountId>sample string 19</GlAccountId>
      <Id>1</Id>
      <Inactive>true</Inactive>
      <Income>true</Income>
      <MerchantId>sample string 20</MerchantId>
      <MerchantIdForSwipe>sample string 21</MerchantIdForSwipe>
      <NoCopiesOnAuth>1</NoCopiesOnAuth>
      <NoCopiesOnSave>1</NoCopiesOnSave>
      <OpenCashDrawer>true</OpenCashDrawer>
      <PaymentMethodGroup>
        <Description>sample string 1</Description>
        <Id>1</Id>
        <Inactive>true</Inactive>
        <MerchantId>sample string 3</MerchantId>
      </PaymentMethodGroup>
      <PaymentType>
        <Description>sample string 1</Description>
        <Id>1</Id>
      </PaymentType>
      <ReceiptFormatId>1</ReceiptFormatId>
      <RequireCheckIndicator>true</RequireCheckIndicator>
      <RequireCvv>true</RequireCvv>
      <RequirePostalCode>sample string 13</RequirePostalCode>
      <ShortDesc>sample string 14</ShortDesc>
      <StoreTenderedAmount>true</StoreTenderedAmount>
      <UpdatedBy>sample string 12</UpdatedBy>
      <UpdatedDateTime>2025-04-24T04:50:35.5866205-07:00</UpdatedDateTime>
      <UseWithCardReader>true</UseWithCardReader>
    </PaymentMethod>
    <ReferenceNumber>sample string 4</ReferenceNumber>
    <ResponseCode>sample string 1</ResponseCode>
    <ResponseMessage>sample string 2</ResponseMessage>
    <ShopperIp>sample string 14</ShopperIp>
    <Succeeded>true</Succeeded>
    <TessituraMerchantServicesAction>sample string 13</TessituraMerchantServicesAction>
  </AuthorizationResponse>
  <EMVStatus>
    <AccountId>9</AccountId>
    <AccountNumber>sample string 4</AccountNumber>
    <AuthCode>sample string 7</AuthCode>
    <CardHolderName>sample string 5</CardHolderName>
    <CardMnemonic>sample string 2</CardMnemonic>
    <DpsTxnRef>sample string 6</DpsTxnRef>
    <PaymentId>10</PaymentId>
    <SignatureRequired>true</SignatureRequired>
    <Status>sample string 1</Status>
    <Succeeded>true</Succeeded>
  </EMVStatus>
</EMVAuthorizationResponse>
Change Version Description Contract Old New
Property Added 15.2.26 IsMoto has been added to EMVAuthorizationRequest EMVAuthorizationRequest EMVAuthorizationRequest.IsMoto
Resource Added 15.0.0 New resource added. EMV