PaymentToken

POST api/PaymentToken/GetInfo

This operation provides information about a saved Credit Card or EFT payment method that corresponds to a specific token. A valid token and a valid authentication key must be provided in order to retrieve information.

GetInfoRequest

NameDescriptionTypeAdditional information
Token

Payment token

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "Token": "65091b5b-2b29-4295-9e0a-f88cd4d82917",
  "AuthenticationKey": "Authentication Key"
}
<GetInfoRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.PaymentToken">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <Token>65091b5b-2b29-4295-9e0a-f88cd4d82917</Token>
</GetInfoRequest>

Response Information

GetInfoResponse

NameDescriptionTypeAdditional information
TokenType

Token type

TokenType
Eft

EFT details

TokenEftInfo
CreditCard

Credit card details

TokenCreditCardInfo
ClientReferenceData

Client reference data

ClientReferenceData
TransactionId

Transaction ID

string
ResponseCode

Operation response code

string
Message

Response message

string

TokenType

Possible enumeration values:

NameValueDescription
Undefined

0

Token type is undefined

CreditCard

1

CreditCard

Eft

2

EFT

TokenEftInfo

NameDescriptionTypeAdditional information
RoutingNumber

The bank routing number. Must only contain numbers.

string
LastFourDigits

Last 4 digits of account number

string
Type

EFT account type - Checking / Savings

EftAccountType
CustomerName

Customer name

string

EftAccountType

Possible enumeration values:

NameValueDescription
Undefined

0

Undefined

Checking

1

Checking

Savings

2

Savings

TokenCreditCardInfo

NameDescriptionTypeAdditional information
LastFourDigits

Last 4 digits of credit card number

string
Type

Credit card type

CreditCardType
ExpirationYear

Year of the expiration of the credit card

integer
ExpirationMonth

Month of the expiration of the credit card

integer
Holder

Card holder

Customer
BaseCardType

Base Credit Card type

CreditCardType

CreditCardType

Possible enumeration values:

NameValueDescription
Undefined

0

Undefined

Visa

1

Visa

MasterCard

2

MasterCard

AmericanExpress

3

American Express

Discover

4

Discover

PinlessDebitGeneric

5

PINless Debit

Star

6

Star

Nyce

7

Nyce

Pulse

8

Pulse

Other

99

Other

Customer

NameDescriptionTypeAdditional information
Name

Customer name

string

Required

Zip

Customer ZIP code

string
Address

Customer address

string

ClientReferenceData

NameDescriptionTypeAdditional information
ClientReferenceData1

Used to pass a reference number such as Policy, Quote, or Claim Number. The value will be searchable in the transaction search report.

string
ClientReferenceData2

Used to pass an external transaction identifier. The value will be searchable in the transaction search report.

string
ClientReferenceData3

Used to pass location data such as the office the transaction originated. The value will be searchable in the transaction search report.

string
ClientReferenceData4

Used to pass additional information with the transaction. The value will be displayed in the transaction details.

string
ClientReferenceData5

Used to pass additional reference source account data such as an account number for a multi-policy account.The value will be searchable in the transaction search report.

string

Response Formats

{
  "TokenType": 1,
  "Eft": null,
  "CreditCard": {
    "LastFourDigits": "1234",
    "Type": 1,
    "ExpirationYear": 2020,
    "ExpirationMonth": 11,
    "Holder": {
      "Name": "John Stevens",
      "Zip": "12345",
      "Address": "test address"
    },
    "BaseCardType": 0
  },
  "ClientReferenceData": null,
  "TransactionId": null,
  "ResponseCode": "Success",
  "Message": null
}
<GetInfoResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.PaymentToken">
  <Message i:nil="true" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts" />
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts" i:nil="true" />
  <CreditCard>
    <BaseCardType>Undefined</BaseCardType>
    <ExpirationMonth>11</ExpirationMonth>
    <ExpirationYear>2020</ExpirationYear>
    <Holder xmlns:d3p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
      <d3p1:Address>test address</d3p1:Address>
      <d3p1:Name>John Stevens</d3p1:Name>
      <d3p1:Zip>12345</d3p1:Zip>
    </Holder>
    <LastFourDigits>1234</LastFourDigits>
    <Type>Visa</Type>
  </CreditCard>
  <Eft i:nil="true" />
  <TokenType>CreditCard</TokenType>
  <TransactionId i:nil="true" />
</GetInfoResponse>

POST api/PaymentToken/GetTokenInfoBatch

This operation provides information about a saved Credit Card or EFT payment methods that corresponds to the specific tokens. The valid tokens and a valid authentication key must be provided in order to retrieve information.

GetTokenInfoBatchRequest

NameDescriptionTypeAdditional information
PaymentTokens

Payment tokens

Collection of string
AuthenticationKey

Instance authentication key

string

Required

ListOfString

Request Formats

 
{
  "PaymentTokens": [
    "sample string 1",
    "sample string 2"
  ],
  "AuthenticationKey": "sample string 1"
}
<GetTokenInfoBatchRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.PaymentToken"><AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 1</AuthenticationKey><PaymentTokens xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"><d2p1:string>sample string 1</d2p1:string><d2p1:string>sample string 2</d2p1:string></PaymentTokens></GetTokenInfoBatchRequest>

Response Information

GetTokenInfoBatchResponse

NameDescriptionTypeAdditional information
TokenInfoResults

A tokens information

Collection of TokenInfo
ResponseCode

Operation response code

string
Message

Response message

string

ListOfTokenInfo

NameDescriptionTypeAdditional information
TokenType

Token type

TokenType
Eft

EFT details

TokenEftInfo
CreditCard

Credit card details

TokenCreditCardInfo
ClientReferenceData

Client reference data

ClientReferenceData
TransactionId

Transaction ID

string

Response Formats

{
  "TokenInfoResults": [
    {
      "TokenType": 0,
      "Eft": {
        "RoutingNumber": "sample string 1",
        "LastFourDigits": "sample string 2",
        "Type": 0,
        "CustomerName": "sample string 3"
      },
      "CreditCard": {
        "LastFourDigits": "sample string 1",
        "Type": 0,
        "ExpirationYear": 1,
        "ExpirationMonth": 1,
        "Holder": {
          "Name": "sample string 1",
          "Zip": "sample string 2",
          "Address": "sample string 3"
        },
        "BaseCardType": 0
      },
      "ClientReferenceData": {
        "ClientReferenceData1": "sample string 1",
        "ClientReferenceData2": "sample string 2",
        "ClientReferenceData3": "sample string 3",
        "ClientReferenceData4": "sample string 4",
        "ClientReferenceData5": "sample string 5"
      },
      "TransactionId": "sample string 1"
    },
    {
      "TokenType": 0,
      "Eft": {
        "RoutingNumber": "sample string 1",
        "LastFourDigits": "sample string 2",
        "Type": 0,
        "CustomerName": "sample string 3"
      },
      "CreditCard": {
        "LastFourDigits": "sample string 1",
        "Type": 0,
        "ExpirationYear": 1,
        "ExpirationMonth": 1,
        "Holder": {
          "Name": "sample string 1",
          "Zip": "sample string 2",
          "Address": "sample string 3"
        },
        "BaseCardType": 0
      },
      "ClientReferenceData": {
        "ClientReferenceData1": "sample string 1",
        "ClientReferenceData2": "sample string 2",
        "ClientReferenceData3": "sample string 3",
        "ClientReferenceData4": "sample string 4",
        "ClientReferenceData5": "sample string 5"
      },
      "TransactionId": "sample string 1"
    }
  ],
  "ResponseCode": "sample string 1",
  "Message": "sample string 2"
}
<GetTokenInfoBatchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.PaymentToken"><Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 2</Message><ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 1</ResponseCode><TokenInfoResults><TokenInfo><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>sample string 1</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2>sample string 2</d4p1:ClientReferenceData2><d4p1:ClientReferenceData3>sample string 3</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4>sample string 4</d4p1:ClientReferenceData4><d4p1:ClientReferenceData5>sample string 5</d4p1:ClientReferenceData5></ClientReferenceData><CreditCard><BaseCardType>Undefined</BaseCardType><ExpirationMonth>1</ExpirationMonth><ExpirationYear>1</ExpirationYear><Holder xmlns:d5p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d5p1:Address>sample string 3</d5p1:Address><d5p1:Name>sample string 1</d5p1:Name><d5p1:Zip>sample string 2</d5p1:Zip></Holder><LastFourDigits>sample string 1</LastFourDigits><Type>Undefined</Type></CreditCard><Eft><CustomerName>sample string 3</CustomerName><LastFourDigits>sample string 2</LastFourDigits><RoutingNumber>sample string 1</RoutingNumber><Type>Undefined</Type></Eft><TokenType>Undefined</TokenType><TransactionId>sample string 1</TransactionId></TokenInfo><TokenInfo><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>sample string 1</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2>sample string 2</d4p1:ClientReferenceData2><d4p1:ClientReferenceData3>sample string 3</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4>sample string 4</d4p1:ClientReferenceData4><d4p1:ClientReferenceData5>sample string 5</d4p1:ClientReferenceData5></ClientReferenceData><CreditCard><BaseCardType>Undefined</BaseCardType><ExpirationMonth>1</ExpirationMonth><ExpirationYear>1</ExpirationYear><Holder xmlns:d5p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d5p1:Address>sample string 3</d5p1:Address><d5p1:Name>sample string 1</d5p1:Name><d5p1:Zip>sample string 2</d5p1:Zip></Holder><LastFourDigits>sample string 1</LastFourDigits><Type>Undefined</Type></CreditCard><Eft><CustomerName>sample string 3</CustomerName><LastFourDigits>sample string 2</LastFourDigits><RoutingNumber>sample string 1</RoutingNumber><Type>Undefined</Type></Eft><TokenType>Undefined</TokenType><TransactionId>sample string 1</TransactionId></TokenInfo></TokenInfoResults></GetTokenInfoBatchResponse>

POST api/PaymentToken/Remove

In case you want to delete a previously saved Credit Card or EFT payment method, you can remove the token that corresponds to it. Just provide the token you want to remove and your authentication key in your POST request, to delete the token.

RemovePaymentTokenRequest

NameDescriptionTypeAdditional information
Token

Payment token

string
CustomerId

A customer id associated with transaction

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "Token": "fe3754ab-be87-40f5-8c75-c5812d85abd6",
  "CustomerId": null,
  "AuthenticationKey": "Authentication Key"
}
<RemovePaymentTokenRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.PaymentToken">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CustomerId i:nil="true" />
  <Token>fe3754ab-be87-40f5-8c75-c5812d85abd6</Token>
</RemovePaymentTokenRequest>

Response Information

RemovePaymentTokenResponse

NameDescriptionTypeAdditional information
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "ResponseCode": "Success",
  "Message": "Success"
}
<RemovePaymentTokenResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.PaymentToken">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
</RemovePaymentTokenResponse>

CreditCard

Credit card operations

POST api/CreditCard/Save

This operation tokenizes all the required information about a credit card payment method. Once the card information is tokenized, you no longer have to provide us any sensitive credit card information. To initiate transactions with a tokenized card simply provide the token that is returned by our API.

SaveCreditCardRequest

NameDescriptionTypeAdditional information
CreditCard

Credit card information

CreditCardDetails
CallbackId

A callback id associated to save credit card transaction

string
ClientReferenceData

Client reference data

ClientReferenceData
CustomerId

A customer id associated with transaction

string
AuthenticationKey

Instance authentication key

string

Required

CreditCardDetails

NameDescriptionTypeAdditional information
ExpirationYear

Year of the expiration of the credit card

integer
ExpirationMonth

Month of the expiration of the credit card

integer
Holder

Card holder

Customer
Number

Credit card number

string

Required

ValidationValue

Credit card CVV code

string

Request Formats

 
{
  "CreditCard": {
    "ExpirationYear": 2019,
    "ExpirationMonth": 11,
    "Holder": {
      "Name": "John Stevens",
      "Zip": "12345",
      "Address": "test address"
    },
    "Number": "4012000033330026",
    "ValidationValue": "123"
  },
  "CallbackId": null,
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": "9cd2bc5c-1a41-44ed-af10-19fe7718cbf1",
    "ClientReferenceData3": "Location",
    "ClientReferenceData4": null,
    "ClientReferenceData5": null
  },
  "CustomerId": null,
  "AuthenticationKey": "Authentication Key"
}
<SaveCreditCardRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CallbackId i:nil="true" />
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2>9cd2bc5c-1a41-44ed-af10-19fe7718cbf1</d2p1:ClientReferenceData2>
    <d2p1:ClientReferenceData3>Location</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4 i:nil="true" />
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <CreditCard>
    <ExpirationMonth>11</ExpirationMonth>
    <ExpirationYear>2019</ExpirationYear>
    <Holder xmlns:d3p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
      <d3p1:Address>test address</d3p1:Address>
      <d3p1:Name>John Stevens</d3p1:Name>
      <d3p1:Zip>12345</d3p1:Zip>
    </Holder>
    <Number>4012000033330026</Number>
    <ValidationValue>123</ValidationValue>
  </CreditCard>
  <CustomerId i:nil="true" />
</SaveCreditCardRequest>

Response Information

SaveCreditCardResponse

NameDescriptionTypeAdditional information
Token

ProcessOne payment token

string
TokenCreationTime

Token creation date and time in merchant time zone

date
TimeZone

Short time zone name with daylight saving time suffix

string
BaseCardType

Base Credit Card type

CreditCardType
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "Token": "8a641362-f676-46d7-a907-e76675c92c5c",
  "TokenCreationTime": "2019-11-19T10:52:07",
  "TimeZone": "PST",
  "BaseCardType": 0,
  "ResponseCode": "Success",
  "Message": "Success"
}
<SaveCreditCardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <BaseCardType>Undefined</BaseCardType>
  <TimeZone>PST</TimeZone>
  <Token>8a641362-f676-46d7-a907-e76675c92c5c</Token>
  <TokenCreationTime>2019-11-19T10:52:07</TokenCreationTime>
</SaveCreditCardResponse>

POST api/CreditCard/Update

This operation provides a way to update information about a previously saved credit card. Refer to the table and examples below to see what information can be updated without a need to generate a new token.

UpdateCreditCardRequest

NameDescriptionTypeAdditional information
Token

Saved CreditCard token

string
ExpirationYear

Year of the expiration of the credit card

integer
ExpirationMonth

Month of the expiration of the credit card

integer
ZipCode

CreditCard holder Zip code

string
CreditCardNetworkType

Credit Card network type

CreditCardNetworkType
HolderAddress

CreditCard holder address

string
AuthenticationKey

Instance authentication key

string

Required

CreditCardNetworkType

Possible enumeration values:

NameValueDescription
Unknown

0

Unknown

Hybrid

1

Hybrid (Debit/Credit) card

Debit

2

Debit card

Credit

3

Credit card

Request Formats

 
{
  "Token": "bb6c3edb-7e23-4d2e-a088-c470c48a0357",
  "ExpirationYear": 2019,
  "ExpirationMonth": 11,
  "ZipCode": "12345",
  "CreditCardNetworkType": 3,
  "HolderAddress": null,
  "AuthenticationKey": "Authentication Key"
}
<UpdateCreditCardRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CreditCardNetworkType>Credit</CreditCardNetworkType>
  <ExpirationMonth>11</ExpirationMonth>
  <ExpirationYear>2019</ExpirationYear>
  <HolderAddress i:nil="true" />
  <Token>bb6c3edb-7e23-4d2e-a088-c470c48a0357</Token>
  <ZipCode>12345</ZipCode>
</UpdateCreditCardRequest>

Response Information

UpdateCreditCardResponse

NameDescriptionTypeAdditional information
TimeZone

Short time zone name with daylight saving time suffix

string
UpdateTime

Update date and time in merchant time zone

date
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "TimeZone": null,
  "UpdateTime": null,
  "ResponseCode": "Success",
  "Message": "Success"
}
<UpdateCreditCardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <TimeZone i:nil="true" />
  <UpdateTime i:nil="true" />
</UpdateCreditCardResponse>

POST api/CreditCard/Charge

This operation allows making a payment with a given credit card, which initiates a transfer of money from a particular customer account to the merchant account. You either have to provide a valid token or include credit card information in your request.

ChargeCreditCardRequest

NameDescriptionTypeAdditional information
Amount

Charge amount

decimal number

Required

ChargeFee

Should we charge with fee (default - true)

boolean
Token

Saved CreditCard token

string
CreditCard

Either CreditCard or token parameter is required. If both are sent, token will be used

CreditCardDetails
ClientReferenceData

Client reference data

ClientReferenceData
IsRecurring

Is recurring charge

boolean
AccountGroupCode

Account group code

string
CallbackId

A callback id associated to charge credit card transaction

string
Save

Enables to save and tokenize credit card information

boolean
ConvenienceFeeType

Customizable convenience fee type that is matched with different types of transactions

string
CustomerId

A customer id associated with transaction

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "Amount": 20.00,
  "ChargeFee": true,
  "Token": null,
  "CreditCard": {
    "ExpirationYear": 2019,
    "ExpirationMonth": 11,
    "Holder": {
      "Name": "John Stevens",
      "Zip": "12345",
      "Address": "test address"
    },
    "Number": "4012000033330026",
    "ValidationValue": "123"
  },
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": "2785ddd0-0355-4114-b6c7-5d3b1b33d6d5",
    "ClientReferenceData3": "Location",
    "ClientReferenceData4": null,
    "ClientReferenceData5": null
  },
  "IsRecurring": false,
  "AccountGroupCode": "Default",
  "CallbackId": null,
  "Save": false,
  "ConvenienceFeeType": null,
  "CustomerId": null,
  "AuthenticationKey": "Authentication Key"
}
<ChargeCreditCardRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <AccountGroupCode>Default</AccountGroupCode>
  <Amount>20.00</Amount>
  <CallbackId i:nil="true" />
  <ChargeFee>true</ChargeFee>
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2>2785ddd0-0355-4114-b6c7-5d3b1b33d6d5</d2p1:ClientReferenceData2>
    <d2p1:ClientReferenceData3>Location</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4 i:nil="true" />
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <ConvenienceFeeType i:nil="true" />
  <CreditCard>
    <ExpirationMonth>11</ExpirationMonth>
    <ExpirationYear>2019</ExpirationYear>
    <Holder xmlns:d3p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
      <d3p1:Address>test address</d3p1:Address>
      <d3p1:Name>John Stevens</d3p1:Name>
      <d3p1:Zip>12345</d3p1:Zip>
    </Holder>
    <Number>4012000033330026</Number>
    <ValidationValue>123</ValidationValue>
  </CreditCard>
  <CustomerId i:nil="true" />
  <IsRecurring>false</IsRecurring>
  <Save>false</Save>
  <Token i:nil="true" />
</ChargeCreditCardRequest>

Response Information

ChargeCreditCardResponse

NameDescriptionTypeAdditional information
Token

ProcessOne payment token

string
TransactionId

Transaction ID

string
TransactionDate

Transaction date and time

date
TimeZone

Transaction time zone

string
AuthorizationCode

A gateway Authorization Code

string
BatchNumber

Number of the batch

integer
CreditCardType

Credit Card type

CreditCardType
HolderName

Card Holder Name

string
HolderZip

Card Holder Zip code

string
BaseCardType

Base Credit Card type

CreditCardType
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "Token": null,
  "TransactionId": null,
  "TransactionDate": "2019-11-19T10:52:07",
  "TimeZone": "PST",
  "AuthorizationCode": null,
  "BatchNumber": 0,
  "CreditCardType": 1,
  "HolderName": "John Stevens",
  "HolderZip": "12345",
  "BaseCardType": 0,
  "ResponseCode": "Success",
  "Message": "Success"
}
<ChargeCreditCardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <AuthorizationCode i:nil="true" />
  <BaseCardType>Undefined</BaseCardType>
  <BatchNumber>0</BatchNumber>
  <CreditCardType>Visa</CreditCardType>
  <HolderName>John Stevens</HolderName>
  <HolderZip>12345</HolderZip>
  <TimeZone>PST</TimeZone>
  <Token i:nil="true" />
  <TransactionDate>2019-11-19T10:52:07</TransactionDate>
  <TransactionId i:nil="true" />
</ChargeCreditCardResponse>

POST api/CreditCard/Void

This operation provides a way to void or cancel a previously made credit card payment that has not been fully processed yet. If a payment was already processed, a refund operation is required. You have to provide the transaction id of a transaction that you want to void. You can include a callback id if you prefer to get the information about a void transaction record by the callback id.

VoidCreditCardRequest

NameDescriptionTypeAdditional information
TransactionId

An id of transaction to void

string

Required

CallbackId

A callback id associated to void transaction

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "TransactionId": "99992",
  "CallbackId": null,
  "AuthenticationKey": "Authentication Key"
}
<VoidCreditCardRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CallbackId i:nil="true" />
  <TransactionId>99992</TransactionId>
</VoidCreditCardRequest>

Response Information

VoidCreditCardResponse

NameDescriptionTypeAdditional information
TransactionId

An id of void transaction

string
AuthorizationCode

A gateway AuthorizationCode

string
BatchNumber

A batch number of void transaction

integer
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "TransactionId": "99992",
  "AuthorizationCode": null,
  "BatchNumber": 0,
  "ResponseCode": "Success",
  "Message": "Success"
}
<VoidCreditCardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <AuthorizationCode i:nil="true" />
  <BatchNumber>0</BatchNumber>
  <TransactionId>99992</TransactionId>
</VoidCreditCardResponse>

POST api/CreditCard/Refund

This operation provides a way to refund a previously made credit card payment that has been fully processed. To initiate a refund, call this API operation and provide a valid transaction id. You can include a callback id if you prefer to get the information about the refund transaction record by the callback id. Note: As payment transactions cannot be refunded until after they have been settled, if the batch has not yet closed for the transaction id in the refund request, the system will automatically Void the payment.

RefundCreditCardRequest

NameDescriptionTypeAdditional information
TransactionId

An id of transaction to refund

string

Required

CallbackId

A callback id associated to refund transaction

string
PartialRefundAmount

Amount to refund

decimal number
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "TransactionId": "99992",
  "CallbackId": null,
  "PartialRefundAmount": 10.0,
  "AuthenticationKey": "Authentication Key"
}
<RefundCreditCardRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CallbackId i:nil="true" />
  <PartialRefundAmount>10</PartialRefundAmount>
  <TransactionId>99992</TransactionId>
</RefundCreditCardRequest>

Response Information

RefundCreditCardResponse

NameDescriptionTypeAdditional information
TransactionId

An id of refund transaction

string
AuthorizationCode

A gateway AuthorizationCode

string
BatchNumber

A batch number of refund transaction

integer
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "TransactionId": "99992",
  "AuthorizationCode": null,
  "BatchNumber": 0,
  "ResponseCode": "Success",
  "Message": "Success"
}
<RefundCreditCardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <AuthorizationCode i:nil="true" />
  <BatchNumber>0</BatchNumber>
  <TransactionId>99992</TransactionId>
</RefundCreditCardResponse>

POST api/CreditCard/Verify

This operation verifies that a provided credit card information represents an existing and valid credit card.

VerifyCreditCardRequest

NameDescriptionTypeAdditional information
CreditCard

Credit card information

CreditCardDetails
CallbackId

A callback id associated with this transaction

string
ClientReferenceData

Client reference data

ClientReferenceData
CustomerId

A customer id associated with transaction

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "CreditCard": {
    "ExpirationYear": 2019,
    "ExpirationMonth": 11,
    "Holder": {
      "Name": "John Stevens",
      "Zip": "12345",
      "Address": "test address"
    },
    "Number": "4012000033330026",
    "ValidationValue": "123"
  },
  "CallbackId": null,
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": "58e05c46-bede-4ab4-b187-3f06a5a09d6a",
    "ClientReferenceData3": "Location",
    "ClientReferenceData4": null,
    "ClientReferenceData5": null
  },
  "CustomerId": null,
  "AuthenticationKey": "Authentication Key"
}
<VerifyCreditCardRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CallbackId i:nil="true" />
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2>58e05c46-bede-4ab4-b187-3f06a5a09d6a</d2p1:ClientReferenceData2>
    <d2p1:ClientReferenceData3>Location</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4 i:nil="true" />
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <CreditCard>
    <ExpirationMonth>11</ExpirationMonth>
    <ExpirationYear>2019</ExpirationYear>
    <Holder xmlns:d3p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
      <d3p1:Address>test address</d3p1:Address>
      <d3p1:Name>John Stevens</d3p1:Name>
      <d3p1:Zip>12345</d3p1:Zip>
    </Holder>
    <Number>4012000033330026</Number>
    <ValidationValue>123</ValidationValue>
  </CreditCard>
  <CustomerId i:nil="true" />
</VerifyCreditCardRequest>

Response Information

VerifyCreditCardResponse

NameDescriptionTypeAdditional information
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "ResponseCode": "Success",
  "Message": "Success"
}
<VerifyCreditCardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
</VerifyCreditCardResponse>

POST api/CreditCard/GetCardData

This operation returns information about a specified credit card by the card number.

GetCardDataRequest

NameDescriptionTypeAdditional information
CreditCardNumber

Credit card number

string

Required

AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "CreditCardNumber": "4444444444444448",
  "AuthenticationKey": "Authentication Key"
}
<GetCardDataRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CreditCardNumber>4444444444444448</CreditCardNumber>
</GetCardDataRequest>

Response Information

GetCardDataResponse

NameDescriptionTypeAdditional information
BaseCardType

Base Credit Card type

CreditCardType
CreditCardNetworkType

Credit Card network type

CreditCardNetworkType
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "BaseCardType": 1,
  "CreditCardNetworkType": 2,
  "ResponseCode": "Success",
  "Message": "Success"
}
<GetCardDataResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <BaseCardType>Visa</BaseCardType>
  <CreditCardNetworkType>Debit</CreditCardNetworkType>
</GetCardDataResponse>

POST api/CreditCard/GetConvenienceFee

This operation returns the credit card convenience fee amount that corresponds to the specified fee type and dollar amount. If fee type is not provided, the API will return the default convenience fee type for your merchant. Convenience fee types vary from merchant to merchant and have to be addressed during contract negotiation.

ConvenienceFeeRequest

NameDescriptionTypeAdditional information
Amount

Charge amount for fee calculation

decimal number
ConvenienceFeeType

Customizable convenience fee type that is matched with different types of transactions

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "Amount": 100.0,
  "ConvenienceFeeType": null,
  "AuthenticationKey": "Authentication Key"
}
<ConvenienceFeeRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <Amount>100</Amount>
  <ConvenienceFeeType i:nil="true" />
</ConvenienceFeeRequest>

Response Information

ConvenienceFeeResponse

NameDescriptionTypeAdditional information
ConvenienceFee

Amount of convenience fee

decimal number
CalculationType

Fee calculation type for current fee tier

string
FlatRate

Flat rate for fee tier, applicable for CalculationType = FlatRate

decimal number
Percent

Percent rate for fee tier, applicable for CalculationType = Percent

decimal number
MinimumAmount

Minimum fee amount, applicable for CalculationType = Percent

decimal number
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "ConvenienceFee": 1.0,
  "CalculationType": null,
  "FlatRate": null,
  "Percent": null,
  "MinimumAmount": null,
  "ResponseCode": "Success",
  "Message": "Success"
}
<ConvenienceFeeResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <CalculationType i:nil="true" />
  <ConvenienceFee>1</ConvenienceFee>
  <FlatRate i:nil="true" />
  <MinimumAmount i:nil="true" />
  <Percent i:nil="true" />
</ConvenienceFeeResponse>

POST api/CreditCard/GetAcceptedCardTypes

This operation returns the list of accepted by merchant card types .

GetAcceptedCardTypesRequest

NameDescriptionTypeAdditional information
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "AuthenticationKey": "Authentication Key"
}
<GetAcceptedCardTypesRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
</GetAcceptedCardTypesRequest>

Response Information

GetAcceptedCardTypesResponse

NameDescriptionTypeAdditional information
AcceptedCardTypes

List of Accepted Card Types

Collection of CreditCardType
ResponseCode

Operation response code

string
Message

Response message

string

ListOfCreditCardType

Possible enumeration values:

NameValueDescription
Undefined

0

Undefined

Visa

1

Visa

MasterCard

2

MasterCard

AmericanExpress

3

American Express

Discover

4

Discover

PinlessDebitGeneric

5

PINless Debit

Star

6

Star

Nyce

7

Nyce

Pulse

8

Pulse

Other

99

Other

Response Formats

{
  "AcceptedCardTypes": [
    3,
    4,
    2
  ],
  "ResponseCode": "Success",
  "Message": "Success"
}
<GetAcceptedCardTypesResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard"><Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message><ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode><AcceptedCardTypes xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.Enums"><d2p1:CreditCardType>AmericanExpress</d2p1:CreditCardType><d2p1:CreditCardType>Discover</d2p1:CreditCardType><d2p1:CreditCardType>MasterCard</d2p1:CreditCardType></AcceptedCardTypes></GetAcceptedCardTypesResponse>

POST api/CreditCard/GetCardUpdates

This operation allows customer policy systems to extract credit card information that has been updated by Evergreen service

GetCardUpdatesRequest

NameDescriptionTypeAdditional information
QueryAuthenticationKeys

Authentication keys to limit search query

Collection of string
StartDate

Start date

date

Required

EndDate

End date

date

Required

AuthenticationKey

Instance authentication key

string

Required

String

Request Formats

 
{
  "QueryAuthenticationKeys": [
    "sample string 1",
    "sample string 2"
  ],
  "StartDate": "2019-11-19T10:52:08",
  "EndDate": "2019-11-19T10:52:08",
  "AuthenticationKey": "sample string 1"
}
<GetCardUpdatesRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard"><AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 1</AuthenticationKey><EndDate>2019-11-19T10:52:08.2141523-08:00</EndDate><QueryAuthenticationKeys xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"><d2p1:string>sample string 1</d2p1:string><d2p1:string>sample string 2</d2p1:string></QueryAuthenticationKeys><StartDate>2019-11-19T10:52:08.2141523-08:00</StartDate></GetCardUpdatesRequest>

Response Information

GetCardUpdatesResponse

NameDescriptionTypeAdditional information
CardData

Credit Cards information array

Collection of CardData
ResponseCode

Operation response code

string
Message

Response message

string

CardData

NameDescriptionTypeAdditional information
ProcessOneToken

One Inc Token ID. Used for mapping updated token data to appropriate token.

string
CardType

Credit Card Type.

CreditCardType
LastFourDigits

Last Four Digits of credit card number.

string
CardExpirationYear

Credit Card Expiration Month

integer
CardExpirationMonth

Credit Card Expiration Month

integer
CustomerName

Customer Name (name on card)

string
UpdateDate

Update date of associated credit card update transaction

date
UpdateTransactionId

Transaction ID of credit card update transaction

string

Response Formats

{
  "CardData": [
    {
      "ProcessOneToken": "sample string 1",
      "CardType": 0,
      "LastFourDigits": "sample string 2",
      "CardExpirationYear": 3,
      "CardExpirationMonth": 4,
      "CustomerName": "sample string 5",
      "UpdateDate": "2019-11-19T10:52:08",
      "UpdateTransactionId": "sample string 7"
    },
    {
      "ProcessOneToken": "sample string 1",
      "CardType": 0,
      "LastFourDigits": "sample string 2",
      "CardExpirationYear": 3,
      "CardExpirationMonth": 4,
      "CustomerName": "sample string 5",
      "UpdateDate": "2019-11-19T10:52:08",
      "UpdateTransactionId": "sample string 7"
    }
  ],
  "ResponseCode": "sample string 1",
  "Message": "sample string 2"
}
<GetCardUpdatesResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.CreditCard"><Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 2</Message><ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 1</ResponseCode><CardData><CardData><CardExpirationMonth>4</CardExpirationMonth><CardExpirationYear>3</CardExpirationYear><CardType>Undefined</CardType><CustomerName>sample string 5</CustomerName><LastFourDigits>sample string 2</LastFourDigits><ProcessOneToken>sample string 1</ProcessOneToken><UpdateDate>2019-11-19T10:52:08.2609188-08:00</UpdateDate><UpdateTransactionId>sample string 7</UpdateTransactionId></CardData><CardData><CardExpirationMonth>4</CardExpirationMonth><CardExpirationYear>3</CardExpirationYear><CardType>Undefined</CardType><CustomerName>sample string 5</CustomerName><LastFourDigits>sample string 2</LastFourDigits><ProcessOneToken>sample string 1</ProcessOneToken><UpdateDate>2019-11-19T10:52:08.2609188-08:00</UpdateDate><UpdateTransactionId>sample string 7</UpdateTransactionId></CardData></CardData></GetCardUpdatesResponse>

HealthStatus

POST api/HealthStatus/Check

The easiest way to make sure you have a solid connection to our API is to check API health status. All you need is a valid authentication key.

CheckHealthStatusRequest

NameDescriptionTypeAdditional information
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "AuthenticationKey": "Authentication Key"
}
<CheckHealthStatusRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.HealthStatus">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
</CheckHealthStatusRequest>

Response Information

CheckHealthStatusResponse

NameDescriptionTypeAdditional information
IsAlive

Is service alive

boolean
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "IsAlive": true,
  "ResponseCode": "Success",
  "Message": "Success"
}
<CheckHealthStatusResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.HealthStatus">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <IsAlive>true</IsAlive>
</CheckHealthStatusResponse>

Transaction

POST api/Transaction/GetTransactionById

This operation provides detailed information about a particular, previously made, transaction. The API will look up the transaction by the Transaction ID that you provide in the body of the POST request. If a transaction ID cannot be found or if your authentication key is not valid. API will respond with an error message.

GetTransactionByIdRequest

NameDescriptionTypeAdditional information
TransactionId

A Transaction Id

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "TransactionId": "99991",
  "AuthenticationKey": "Authentication Key"
}
<GetTransactionByIdRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <TransactionId>99991</TransactionId>
</GetTransactionByIdRequest>

Response Information

GetTransactionByIdResponse

NameDescriptionTypeAdditional information
TransactionInformation

A transaction information

TransactionInformation
ResponseCode

Operation response code

string
Message

Response message

string

TransactionInformation

NameDescriptionTypeAdditional information
TransactionId

Transaction Id

string
InternalReferenceTransactionId

Internal Reference Transaction Id

string
OriginalAmount

Original amount of the transaction

decimal number
PostedAmount

Posted amount of the transaction

decimal number
TransactionType

Transaction type

TransactionType
TransactionStatus

Transaction status

TransactionStatus
PaymentDate

Payment date

date
TimeZone

Client time zone

string
CreditCardType

Credit card type

CreditCardType
LastFourDigits

Last 4 digits of the credit card or the bank account

string
RoutingNumber

Routing number

string
AccountNumber

Account number

string
BatchNumber

Batch number

integer
InstanceName

Merchant instance name

string
CustomerName

Customer name

string
ClientReferenceData

Client extra data

ClientReferenceData
ProcessOneToken

ProcessOne token

string
CreditCardExpirationMonth

Credit card expiration month

integer
CreditCardExpirationYear

Credit card expiration year

integer
BankName

Bank name

string
BankAccountType

Bank account type

EftAccountType
ReturnReasonType

Return reason type

ReturnReasonType
ReturnReasonCode

Return reason code

string
BaseCardType

Base card type

CreditCardType
AccountGroupCode

Account group code

string
CustomerId

Customer Id

string

TransactionType

Possible enumeration values:

NameValueDescription
Undefined

0

Undefined

ChargeCreditCard

1

Charge by Credit Card

RefundCreditCard

2

Refund payment by Credit Card

VoidCreditCard

3

Void payment by Credit Card

CreditEft

5

Charge by credit electronic fund transfer

DebitEftNoFee

6

Charge by debit electronic fund transfer

VoidEft

7

Void EFT payment

ChargeBackDebit

9

Chargeback debit

ChargeBackCredit

10

Chargeback Credit

SaveCreditCard

11

Save CreditCard

RemoveSavedCreditCard

12

Remove saved Credit Card

RecurringChargeCreditCard

13

Recurring Credit Card Charge

ChargeCreditCardNoFee

14

Charge by Credit Card without fee

ReturnedEft

15

EFT Returned

AchDebitPassthrough

16

ACH Debit Pass-through

AchCreditPassthrough

17

ACH Credit Pass-through

RefundEft

18

EFT Refund

DebitSweepForEftCredit

19

EFT Debit Sweep For EFT Credit

AchReturnPassthrough

20

ACH Return Pass-through

SaveEft

21

Save EFT

DebitEft

22

EFT Debit

RecurringEft

23

Recurring EFT Payment

RemoveSavedEft

24

Remove Saved EFT

AdjustmentDebit

25

Adjustment Debit

AdjustmentCredit

26

Adjustment Credit

VoidAdjustment

27

Void Adjustment

VerifyCreditCard

28

Verify Credit Card

VerifyBankAccount

29

Verify Bank Account

CreditBankAccount

31

Credit Bank Account

VoidBankAccountCredit

32

Void Bank Account Credit

CreatePrepaidProfile

33

Create Prepaid Profile

UpdatePrepaidProfile

34

Update Prepaid Profile

LoadPrepaidAccount

35

Load Prepaid Account

ReversePrepaidAccountLoad

36

Reverse Prepaid AccountLoad

ReleaseLoadPrepaidAccount

37

Release Load Prepaid Account

DisbursePrepaidAccountEft

38

Disburse Prepaid Account Eft

DisbursePrepaidAccountCheck

39

Disburse Prepaid Account Check

ChangePrepaidAccountStatus

40

Change Prepaid Account Status

AddPrepaidCard

41

Add Prepaid Card

ChangePrepaidCardStatus

42

Change Prepaid Card Status

ReplacePrepaidCard

43

Replace Prepaid Card

ActivatePrepaidCard

44

Activate Prepaid Card

ReservePrepaidCard

45

Reserve Prepaid Card

LostStolenPrepaidCard

47

Lost Stolen Prepaid Card

OrderPrepaidCards

48

Order Prepaid Cards

ReturnedCreditBankAccount

49

Returned Credit Bank Account

TransactionStatus

Possible enumeration values:

NameValueDescription
Undefined

0

Transaction status is undefined

InProcess

1

Transaction has been started

Successful

2

Transaction has been processed successfully

Failed

3

Transaction failed

Voided

4

Transaction voided

Canceled

5

Transaction canceled

Reversed

6

Transaction reversed

CardReleased

7

Card released

Returned

8

Transaction returned

ReturnReasonType

Possible enumeration values:

NameValueDescription
Undefined

0

Undefined

ChargebackCredit

1

Chargeback Credit

Eft

2

Eft

Response Formats

{
  "TransactionInformation": {
    "TransactionId": "99991",
    "InternalReferenceTransactionId": null,
    "OriginalAmount": 100.0,
    "PostedAmount": 100.0,
    "TransactionType": 5,
    "TransactionStatus": 2,
    "PaymentDate": "2019-11-19T10:52:08",
    "TimeZone": "PST",
    "CreditCardType": 0,
    "LastFourDigits": "1234",
    "RoutingNumber": "123123123",
    "AccountNumber": "123123124",
    "BatchNumber": 11,
    "InstanceName": "merchant instance name",
    "CustomerName": "John Stevens",
    "ClientReferenceData": {
      "ClientReferenceData1": "1234",
      "ClientReferenceData2": null,
      "ClientReferenceData3": "test address",
      "ClientReferenceData4": null,
      "ClientReferenceData5": null
    },
    "ProcessOneToken": null,
    "CreditCardExpirationMonth": null,
    "CreditCardExpirationYear": null,
    "BankName": null,
    "BankAccountType": 0,
    "ReturnReasonType": null,
    "ReturnReasonCode": null,
    "BaseCardType": null,
    "AccountGroupCode": null,
    "CustomerId": null
  },
  "ResponseCode": "Success",
  "Message": "Success"
}
<GetTransactionByIdResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <TransactionInformation>
    <AccountGroupCode i:nil="true" />
    <AccountNumber>123123124</AccountNumber>
    <BankAccountType>Undefined</BankAccountType>
    <BankName i:nil="true" />
    <BaseCardType i:nil="true" />
    <BatchNumber>11</BatchNumber>
    <ClientReferenceData xmlns:d3p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
      <d3p1:ClientReferenceData1>1234</d3p1:ClientReferenceData1>
      <d3p1:ClientReferenceData2 i:nil="true" />
      <d3p1:ClientReferenceData3>test address</d3p1:ClientReferenceData3>
      <d3p1:ClientReferenceData4 i:nil="true" />
      <d3p1:ClientReferenceData5 i:nil="true" />
    </ClientReferenceData>
    <CreditCardExpirationMonth i:nil="true" />
    <CreditCardExpirationYear i:nil="true" />
    <CreditCardType>Undefined</CreditCardType>
    <CustomerId i:nil="true" />
    <CustomerName>John Stevens</CustomerName>
    <InstanceName>merchant instance name</InstanceName>
    <InternalReferenceTransactionId i:nil="true" />
    <LastFourDigits>1234</LastFourDigits>
    <OriginalAmount>100</OriginalAmount>
    <PaymentDate>2019-11-19T10:52:08</PaymentDate>
    <PostedAmount>100</PostedAmount>
    <ProcessOneToken i:nil="true" />
    <ReturnReasonCode i:nil="true" />
    <ReturnReasonType i:nil="true" />
    <RoutingNumber>123123123</RoutingNumber>
    <TimeZone>PST</TimeZone>
    <TransactionId>99991</TransactionId>
    <TransactionStatus>Successful</TransactionStatus>
    <TransactionType>CreditEft</TransactionType>
  </TransactionInformation>
</GetTransactionByIdResponse>

POST api/Transaction/GetTransactionByCallbackId

This operation provides a detailed information about a particular, previously made, transaction. A Callback ID is used to look up the transaction. Like other operations, a valid and existing callback id has to be provided in the request.

GetTransactionByCallbackIdRequest

NameDescriptionTypeAdditional information
CallbackId

A Transaction Callback Id

string

Required

AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "CallbackId": "123",
  "AuthenticationKey": "Authentication Key"
}
<GetTransactionByCallbackIdRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CallbackId>123</CallbackId>
</GetTransactionByCallbackIdRequest>

Response Information

GetTransactionByCallbackIdResponse

NameDescriptionTypeAdditional information
TransactionInformation

A transaction information

TransactionInformation
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "TransactionInformation": {
    "TransactionId": "1579",
    "InternalReferenceTransactionId": null,
    "OriginalAmount": 100.0,
    "PostedAmount": 100.0,
    "TransactionType": 5,
    "TransactionStatus": 2,
    "PaymentDate": "2019-11-19T10:52:08",
    "TimeZone": "PST",
    "CreditCardType": 0,
    "LastFourDigits": "1234",
    "RoutingNumber": "123123123",
    "AccountNumber": "123123124",
    "BatchNumber": 11,
    "InstanceName": "merchant instance name",
    "CustomerName": "John Stevens",
    "ClientReferenceData": {
      "ClientReferenceData1": "1234",
      "ClientReferenceData2": null,
      "ClientReferenceData3": "test address",
      "ClientReferenceData4": null,
      "ClientReferenceData5": null
    },
    "ProcessOneToken": null,
    "CreditCardExpirationMonth": null,
    "CreditCardExpirationYear": null,
    "BankName": null,
    "BankAccountType": 0,
    "ReturnReasonType": null,
    "ReturnReasonCode": null,
    "BaseCardType": null,
    "AccountGroupCode": null,
    "CustomerId": null
  },
  "ResponseCode": "Success",
  "Message": "Success"
}
<GetTransactionByCallbackIdResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <TransactionInformation>
    <AccountGroupCode i:nil="true" />
    <AccountNumber>123123124</AccountNumber>
    <BankAccountType>Undefined</BankAccountType>
    <BankName i:nil="true" />
    <BaseCardType i:nil="true" />
    <BatchNumber>11</BatchNumber>
    <ClientReferenceData xmlns:d3p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
      <d3p1:ClientReferenceData1>1234</d3p1:ClientReferenceData1>
      <d3p1:ClientReferenceData2 i:nil="true" />
      <d3p1:ClientReferenceData3>test address</d3p1:ClientReferenceData3>
      <d3p1:ClientReferenceData4 i:nil="true" />
      <d3p1:ClientReferenceData5 i:nil="true" />
    </ClientReferenceData>
    <CreditCardExpirationMonth i:nil="true" />
    <CreditCardExpirationYear i:nil="true" />
    <CreditCardType>Undefined</CreditCardType>
    <CustomerId i:nil="true" />
    <CustomerName>John Stevens</CustomerName>
    <InstanceName>merchant instance name</InstanceName>
    <InternalReferenceTransactionId i:nil="true" />
    <LastFourDigits>1234</LastFourDigits>
    <OriginalAmount>100</OriginalAmount>
    <PaymentDate>2019-11-19T10:52:08</PaymentDate>
    <PostedAmount>100</PostedAmount>
    <ProcessOneToken i:nil="true" />
    <ReturnReasonCode i:nil="true" />
    <ReturnReasonType i:nil="true" />
    <RoutingNumber>123123123</RoutingNumber>
    <TimeZone>PST</TimeZone>
    <TransactionId>1579</TransactionId>
    <TransactionStatus>Successful</TransactionStatus>
    <TransactionType>CreditEft</TransactionType>
  </TransactionInformation>
</GetTransactionByCallbackIdResponse>

POST api/Transaction/GetTransactionsByBatchId

This operation provides a detailed information about all transactions that are included in the same batch with a specific batch id. In addition to your personal authentication key, you need to provide one or more authentication keys which will be used to filter transactions.

GetTransactionsByBatchIdRequest

NameDescriptionTypeAdditional information
QueryAuthenticationKeys

Authentication keys to limit search query

Collection of string

Required

BatchId

A Transaction Batch Id

string
TransactionStatuses

Transaction statuses to limit search query

Collection of TransactionStatus
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "QueryAuthenticationKeys": [
    "Authentication Key",
    "50a14059-d14d-4f86-ad3a-b53629d500c5"
  ],
  "BatchId": "11",
  "TransactionStatuses": null,
  "AuthenticationKey": "Authentication Key"
}
<GetTransactionsByBatchIdRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction"><AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey><BatchId>11</BatchId><QueryAuthenticationKeys xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"><d2p1:string>Authentication Key</d2p1:string><d2p1:string>50a14059-d14d-4f86-ad3a-b53629d500c5</d2p1:string></QueryAuthenticationKeys><TransactionStatuses xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.Enums" i:nil="true" /></GetTransactionsByBatchIdRequest>

Response Information

GetTransactionsByBatchIdResponse

NameDescriptionTypeAdditional information
Transactions

A transactions information

Collection of TransactionInformation
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "Transactions": [
    {
      "TransactionId": "1577",
      "InternalReferenceTransactionId": null,
      "OriginalAmount": 100.0,
      "PostedAmount": 100.0,
      "TransactionType": 5,
      "TransactionStatus": 2,
      "PaymentDate": "2019-11-19T10:52:08",
      "TimeZone": "PST",
      "CreditCardType": 0,
      "LastFourDigits": "1234",
      "RoutingNumber": "123123123",
      "AccountNumber": "123123124",
      "BatchNumber": 11,
      "InstanceName": "merchant instance name",
      "CustomerName": "John Stevens",
      "ClientReferenceData": {
        "ClientReferenceData1": "1234",
        "ClientReferenceData2": null,
        "ClientReferenceData3": "test address",
        "ClientReferenceData4": null,
        "ClientReferenceData5": null
      },
      "ProcessOneToken": null,
      "CreditCardExpirationMonth": null,
      "CreditCardExpirationYear": null,
      "BankName": null,
      "BankAccountType": 0,
      "ReturnReasonType": null,
      "ReturnReasonCode": null,
      "BaseCardType": null,
      "AccountGroupCode": null,
      "CustomerId": null
    },
    {
      "TransactionId": "1578",
      "InternalReferenceTransactionId": null,
      "OriginalAmount": 100.0,
      "PostedAmount": 100.0,
      "TransactionType": 5,
      "TransactionStatus": 2,
      "PaymentDate": "2019-11-19T10:52:08",
      "TimeZone": "PST",
      "CreditCardType": 0,
      "LastFourDigits": "1234",
      "RoutingNumber": "123123123",
      "AccountNumber": "123123124",
      "BatchNumber": 11,
      "InstanceName": "merchant instance name",
      "CustomerName": "John Stevens",
      "ClientReferenceData": {
        "ClientReferenceData1": "1234",
        "ClientReferenceData2": null,
        "ClientReferenceData3": "test address",
        "ClientReferenceData4": null,
        "ClientReferenceData5": null
      },
      "ProcessOneToken": null,
      "CreditCardExpirationMonth": null,
      "CreditCardExpirationYear": null,
      "BankName": null,
      "BankAccountType": 0,
      "ReturnReasonType": null,
      "ReturnReasonCode": null,
      "BaseCardType": null,
      "AccountGroupCode": null,
      "CustomerId": null
    }
  ],
  "ResponseCode": "Success",
  "Message": "Success"
}
<GetTransactionsByBatchIdResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction"><Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message><ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode><Transactions><TransactionInformation><AccountGroupCode i:nil="true" /><AccountNumber>123123124</AccountNumber><BankAccountType>Undefined</BankAccountType><BankName i:nil="true" /><BaseCardType i:nil="true" /><BatchNumber>11</BatchNumber><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>1234</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2 i:nil="true" /><d4p1:ClientReferenceData3>test address</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4 i:nil="true" /><d4p1:ClientReferenceData5 i:nil="true" /></ClientReferenceData><CreditCardExpirationMonth i:nil="true" /><CreditCardExpirationYear i:nil="true" /><CreditCardType>Undefined</CreditCardType><CustomerId i:nil="true" /><CustomerName>John Stevens</CustomerName><InstanceName>merchant instance name</InstanceName><InternalReferenceTransactionId i:nil="true" /><LastFourDigits>1234</LastFourDigits><OriginalAmount>100</OriginalAmount><PaymentDate>2019-11-19T10:52:08.9796661-08:00</PaymentDate><PostedAmount>100</PostedAmount><ProcessOneToken i:nil="true" /><ReturnReasonCode i:nil="true" /><ReturnReasonType i:nil="true" /><RoutingNumber>123123123</RoutingNumber><TimeZone>PST</TimeZone><TransactionId>1577</TransactionId><TransactionStatus>Successful</TransactionStatus><TransactionType>CreditEft</TransactionType></TransactionInformation><TransactionInformation><AccountGroupCode i:nil="true" /><AccountNumber>123123124</AccountNumber><BankAccountType>Undefined</BankAccountType><BankName i:nil="true" /><BaseCardType i:nil="true" /><BatchNumber>11</BatchNumber><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>1234</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2 i:nil="true" /><d4p1:ClientReferenceData3>test address</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4 i:nil="true" /><d4p1:ClientReferenceData5 i:nil="true" /></ClientReferenceData><CreditCardExpirationMonth i:nil="true" /><CreditCardExpirationYear i:nil="true" /><CreditCardType>Undefined</CreditCardType><CustomerId i:nil="true" /><CustomerName>John Stevens</CustomerName><InstanceName>merchant instance name</InstanceName><InternalReferenceTransactionId i:nil="true" /><LastFourDigits>1234</LastFourDigits><OriginalAmount>100</OriginalAmount><PaymentDate>2019-11-19T10:52:08.9796661-08:00</PaymentDate><PostedAmount>100</PostedAmount><ProcessOneToken i:nil="true" /><ReturnReasonCode i:nil="true" /><ReturnReasonType i:nil="true" /><RoutingNumber>123123123</RoutingNumber><TimeZone>PST</TimeZone><TransactionId>1578</TransactionId><TransactionStatus>Successful</TransactionStatus><TransactionType>CreditEft</TransactionType></TransactionInformation></Transactions></GetTransactionsByBatchIdResponse>

POST api/Transaction/GetTransactionsByType

This operation provides a detailed information about all transactions that match any of the specified transaction types. In your request, you can provide one or more transaction types and authentication keys to expand or limit the scope of your query. You have to provide a specific time frame to limit your search.

GetTransactionsByTypeRequest

NameDescriptionTypeAdditional information
Types

Transaction types

Collection of TransactionType

Required

StartDate

Start date

date
EndDate

End date

date
QueryAuthenticationKeys

Authentication keys to limit search query

Collection of string

Required

TransactionStatuses

Transaction statuses to limit search query

Collection of TransactionStatus
AfterTransactionId

Minimum transaction number (will not be included in the result)

integer
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "Types": [
    5,
    1
  ],
  "StartDate": "2019-11-09T10:52:09",
  "EndDate": "2019-11-19T10:52:09",
  "QueryAuthenticationKeys": [
    "Authentication Key",
    "f5331e09-670f-4795-864b-058fbf871031"
  ],
  "TransactionStatuses": null,
  "AfterTransactionId": null,
  "AuthenticationKey": "Authentication Key"
}
<GetTransactionsByTypeRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction"><AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey><AfterTransactionId i:nil="true" /><EndDate>2019-11-19T10:52:09.2140481-08:00</EndDate><QueryAuthenticationKeys xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"><d2p1:string>Authentication Key</d2p1:string><d2p1:string>f5331e09-670f-4795-864b-058fbf871031</d2p1:string></QueryAuthenticationKeys><StartDate>2019-11-09T10:52:09.2140481-08:00</StartDate><TransactionStatuses xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.Enums" i:nil="true" /><Types xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.Enums"><d2p1:TransactionType>CreditEft</d2p1:TransactionType><d2p1:TransactionType>ChargeCreditCard</d2p1:TransactionType></Types></GetTransactionsByTypeRequest>

Response Information

GetTransactionsByTypeResponse

NameDescriptionTypeAdditional information
Transactions

Collection of transactions

Collection of TransactionInformation
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "Transactions": [
    {
      "TransactionId": "1580",
      "InternalReferenceTransactionId": null,
      "OriginalAmount": 100.0,
      "PostedAmount": 100.0,
      "TransactionType": 5,
      "TransactionStatus": 2,
      "PaymentDate": "2019-11-19T10:52:09",
      "TimeZone": "PST",
      "CreditCardType": 0,
      "LastFourDigits": "1234",
      "RoutingNumber": "123123123",
      "AccountNumber": "123123124",
      "BatchNumber": 11,
      "InstanceName": "merchant instance name",
      "CustomerName": "John Stevens",
      "ClientReferenceData": {
        "ClientReferenceData1": "1234",
        "ClientReferenceData2": null,
        "ClientReferenceData3": "test address",
        "ClientReferenceData4": null,
        "ClientReferenceData5": null
      },
      "ProcessOneToken": null,
      "CreditCardExpirationMonth": null,
      "CreditCardExpirationYear": null,
      "BankName": null,
      "BankAccountType": 0,
      "ReturnReasonType": null,
      "ReturnReasonCode": null,
      "BaseCardType": null,
      "AccountGroupCode": null,
      "CustomerId": null
    },
    {
      "TransactionId": "1581",
      "InternalReferenceTransactionId": null,
      "OriginalAmount": 100.0,
      "PostedAmount": 100.0,
      "TransactionType": 5,
      "TransactionStatus": 2,
      "PaymentDate": "2019-11-19T10:52:09",
      "TimeZone": "PST",
      "CreditCardType": 0,
      "LastFourDigits": "1234",
      "RoutingNumber": "123123123",
      "AccountNumber": "123123124",
      "BatchNumber": 11,
      "InstanceName": "merchant instance name",
      "CustomerName": "John Stevens",
      "ClientReferenceData": {
        "ClientReferenceData1": "1234",
        "ClientReferenceData2": null,
        "ClientReferenceData3": "test address",
        "ClientReferenceData4": null,
        "ClientReferenceData5": null
      },
      "ProcessOneToken": null,
      "CreditCardExpirationMonth": null,
      "CreditCardExpirationYear": null,
      "BankName": null,
      "BankAccountType": 0,
      "ReturnReasonType": null,
      "ReturnReasonCode": null,
      "BaseCardType": null,
      "AccountGroupCode": null,
      "CustomerId": null
    }
  ],
  "ResponseCode": "Success",
  "Message": "Success"
}
<GetTransactionsByTypeResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction"><Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message><ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode><Transactions><TransactionInformation><AccountGroupCode i:nil="true" /><AccountNumber>123123124</AccountNumber><BankAccountType>Undefined</BankAccountType><BankName i:nil="true" /><BaseCardType i:nil="true" /><BatchNumber>11</BatchNumber><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>1234</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2 i:nil="true" /><d4p1:ClientReferenceData3>test address</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4 i:nil="true" /><d4p1:ClientReferenceData5 i:nil="true" /></ClientReferenceData><CreditCardExpirationMonth i:nil="true" /><CreditCardExpirationYear i:nil="true" /><CreditCardType>Undefined</CreditCardType><CustomerId i:nil="true" /><CustomerName>John Stevens</CustomerName><InstanceName>merchant instance name</InstanceName><InternalReferenceTransactionId i:nil="true" /><LastFourDigits>1234</LastFourDigits><OriginalAmount>100</OriginalAmount><PaymentDate>2019-11-19T10:52:09.2609212-08:00</PaymentDate><PostedAmount>100</PostedAmount><ProcessOneToken i:nil="true" /><ReturnReasonCode i:nil="true" /><ReturnReasonType i:nil="true" /><RoutingNumber>123123123</RoutingNumber><TimeZone>PST</TimeZone><TransactionId>1580</TransactionId><TransactionStatus>Successful</TransactionStatus><TransactionType>CreditEft</TransactionType></TransactionInformation><TransactionInformation><AccountGroupCode i:nil="true" /><AccountNumber>123123124</AccountNumber><BankAccountType>Undefined</BankAccountType><BankName i:nil="true" /><BaseCardType i:nil="true" /><BatchNumber>11</BatchNumber><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>1234</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2 i:nil="true" /><d4p1:ClientReferenceData3>test address</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4 i:nil="true" /><d4p1:ClientReferenceData5 i:nil="true" /></ClientReferenceData><CreditCardExpirationMonth i:nil="true" /><CreditCardExpirationYear i:nil="true" /><CreditCardType>Undefined</CreditCardType><CustomerId i:nil="true" /><CustomerName>John Stevens</CustomerName><InstanceName>merchant instance name</InstanceName><InternalReferenceTransactionId i:nil="true" /><LastFourDigits>1234</LastFourDigits><OriginalAmount>100</OriginalAmount><PaymentDate>2019-11-19T10:52:09.2609212-08:00</PaymentDate><PostedAmount>100</PostedAmount><ProcessOneToken i:nil="true" /><ReturnReasonCode i:nil="true" /><ReturnReasonType i:nil="true" /><RoutingNumber>123123123</RoutingNumber><TimeZone>PST</TimeZone><TransactionId>1581</TransactionId><TransactionStatus>Successful</TransactionStatus><TransactionType>CreditEft</TransactionType></TransactionInformation></Transactions></GetTransactionsByTypeResponse>

POST api/Transaction/UpdateTransactionMetadata

Most of the transactions include ClientReferenceData metadata fields that you can use to link additional information to transaction record. This operation allows to update the metadata fields of a particular transaction with a specific transaction id. Specify the Transaction ID and the new value of the metadata fields that you want to update.

UpdateTransactionMetadataRequest

NameDescriptionTypeAdditional information
TransactionId

Transaction id

integer
ClientReferenceData

Client reference data

ClientReferenceData
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "TransactionId": 99991,
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": null,
    "ClientReferenceData3": "test address",
    "ClientReferenceData4": "additional info",
    "ClientReferenceData5": null
  },
  "AuthenticationKey": "Authentication Key"
}
<UpdateTransactionMetadataRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2 i:nil="true" />
    <d2p1:ClientReferenceData3>test address</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4>additional info</d2p1:ClientReferenceData4>
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <TransactionId>99991</TransactionId>
</UpdateTransactionMetadataRequest>

Response Information

UpdateTransactionMetadataResponse

NameDescriptionTypeAdditional information
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "ResponseCode": "Success",
  "Message": "Success"
}
<UpdateTransactionMetadataResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
</UpdateTransactionMetadataResponse>

POST api/Transaction/GetTransactionsByCustomerAndClientRefData

This operation provides a detailed information about all transactions that match customer id. You have to provide a specific time frame to limit your search.

GetTransactionsByCustomerAndClientRefDataRequest

NameDescriptionTypeAdditional information
CustomerId

External Customer id

string

Required

StartDate

Transaction start date

date
EndDate

Transaction end date

date
TransactionTypes

Transaction types

Collection of TransactionType
TransactionStatuses

Transaction statuses

Collection of TransactionStatus
ClientReferenceData

Client reference data

ClientReferenceData
Limit

Transactions limit (how many items return)

integer
Offset

Transaction offset (rows to skip before starting to return rows)

integer
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "CustomerId": "sample string 1",
  "StartDate": "2019-11-19T10:52:09",
  "EndDate": "2019-11-19T10:52:09",
  "TransactionTypes": [
    0,
    0
  ],
  "TransactionStatuses": [
    0,
    0
  ],
  "ClientReferenceData": {
    "ClientReferenceData1": "sample string 1",
    "ClientReferenceData2": "sample string 2",
    "ClientReferenceData3": "sample string 3",
    "ClientReferenceData4": "sample string 4",
    "ClientReferenceData5": "sample string 5"
  },
  "Limit": 1,
  "Offset": 1,
  "AuthenticationKey": "sample string 2"
}
<GetTransactionsByCustomerAndClientRefDataRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction"><AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 2</AuthenticationKey><ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d2p1:ClientReferenceData1>sample string 1</d2p1:ClientReferenceData1><d2p1:ClientReferenceData2>sample string 2</d2p1:ClientReferenceData2><d2p1:ClientReferenceData3>sample string 3</d2p1:ClientReferenceData3><d2p1:ClientReferenceData4>sample string 4</d2p1:ClientReferenceData4><d2p1:ClientReferenceData5>sample string 5</d2p1:ClientReferenceData5></ClientReferenceData><CustomerId>sample string 1</CustomerId><EndDate>2019-11-19T10:52:09.6984502-08:00</EndDate><Limit>1</Limit><Offset>1</Offset><StartDate>2019-11-19T10:52:09.6984502-08:00</StartDate><TransactionStatuses xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.Enums"><d2p1:TransactionStatus>Undefined</d2p1:TransactionStatus><d2p1:TransactionStatus>Undefined</d2p1:TransactionStatus></TransactionStatuses><TransactionTypes xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.Enums"><d2p1:TransactionType>Undefined</d2p1:TransactionType><d2p1:TransactionType>Undefined</d2p1:TransactionType></TransactionTypes></GetTransactionsByCustomerAndClientRefDataRequest>

Response Information

GetTransactionsByCustomerAndClientRefDataResponse

NameDescriptionTypeAdditional information
Transactions

Collection of transactions

Collection of TransactionInformation
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "Transactions": [
    {
      "TransactionId": "sample string 1",
      "InternalReferenceTransactionId": "sample string 2",
      "OriginalAmount": 3.0,
      "PostedAmount": 4.0,
      "TransactionType": 0,
      "TransactionStatus": 0,
      "PaymentDate": "2019-11-19T10:52:09",
      "TimeZone": "sample string 6",
      "CreditCardType": 0,
      "LastFourDigits": "sample string 7",
      "RoutingNumber": "sample string 8",
      "AccountNumber": "sample string 9",
      "BatchNumber": 10,
      "InstanceName": "sample string 11",
      "CustomerName": "sample string 12",
      "ClientReferenceData": {
        "ClientReferenceData1": "sample string 1",
        "ClientReferenceData2": "sample string 2",
        "ClientReferenceData3": "sample string 3",
        "ClientReferenceData4": "sample string 4",
        "ClientReferenceData5": "sample string 5"
      },
      "ProcessOneToken": "sample string 13",
      "CreditCardExpirationMonth": 1,
      "CreditCardExpirationYear": 1,
      "BankName": "sample string 14",
      "BankAccountType": 0,
      "ReturnReasonType": 0,
      "ReturnReasonCode": "sample string 15",
      "BaseCardType": 0,
      "AccountGroupCode": "sample string 16",
      "CustomerId": "sample string 17"
    },
    {
      "TransactionId": "sample string 1",
      "InternalReferenceTransactionId": "sample string 2",
      "OriginalAmount": 3.0,
      "PostedAmount": 4.0,
      "TransactionType": 0,
      "TransactionStatus": 0,
      "PaymentDate": "2019-11-19T10:52:09",
      "TimeZone": "sample string 6",
      "CreditCardType": 0,
      "LastFourDigits": "sample string 7",
      "RoutingNumber": "sample string 8",
      "AccountNumber": "sample string 9",
      "BatchNumber": 10,
      "InstanceName": "sample string 11",
      "CustomerName": "sample string 12",
      "ClientReferenceData": {
        "ClientReferenceData1": "sample string 1",
        "ClientReferenceData2": "sample string 2",
        "ClientReferenceData3": "sample string 3",
        "ClientReferenceData4": "sample string 4",
        "ClientReferenceData5": "sample string 5"
      },
      "ProcessOneToken": "sample string 13",
      "CreditCardExpirationMonth": 1,
      "CreditCardExpirationYear": 1,
      "BankName": "sample string 14",
      "BankAccountType": 0,
      "ReturnReasonType": 0,
      "ReturnReasonCode": "sample string 15",
      "BaseCardType": 0,
      "AccountGroupCode": "sample string 16",
      "CustomerId": "sample string 17"
    }
  ],
  "ResponseCode": "sample string 1",
  "Message": "sample string 2"
}
<GetTransactionsByCustomerAndClientRefDataResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Transaction"><Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 2</Message><ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 1</ResponseCode><Transactions><TransactionInformation><AccountGroupCode>sample string 16</AccountGroupCode><AccountNumber>sample string 9</AccountNumber><BankAccountType>Undefined</BankAccountType><BankName>sample string 14</BankName><BaseCardType>Undefined</BaseCardType><BatchNumber>10</BatchNumber><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>sample string 1</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2>sample string 2</d4p1:ClientReferenceData2><d4p1:ClientReferenceData3>sample string 3</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4>sample string 4</d4p1:ClientReferenceData4><d4p1:ClientReferenceData5>sample string 5</d4p1:ClientReferenceData5></ClientReferenceData><CreditCardExpirationMonth>1</CreditCardExpirationMonth><CreditCardExpirationYear>1</CreditCardExpirationYear><CreditCardType>Undefined</CreditCardType><CustomerId>sample string 17</CustomerId><CustomerName>sample string 12</CustomerName><InstanceName>sample string 11</InstanceName><InternalReferenceTransactionId>sample string 2</InternalReferenceTransactionId><LastFourDigits>sample string 7</LastFourDigits><OriginalAmount>3</OriginalAmount><PaymentDate>2019-11-19T10:52:09.7609159-08:00</PaymentDate><PostedAmount>4</PostedAmount><ProcessOneToken>sample string 13</ProcessOneToken><ReturnReasonCode>sample string 15</ReturnReasonCode><ReturnReasonType>Undefined</ReturnReasonType><RoutingNumber>sample string 8</RoutingNumber><TimeZone>sample string 6</TimeZone><TransactionId>sample string 1</TransactionId><TransactionStatus>Undefined</TransactionStatus><TransactionType>Undefined</TransactionType></TransactionInformation><TransactionInformation><AccountGroupCode>sample string 16</AccountGroupCode><AccountNumber>sample string 9</AccountNumber><BankAccountType>Undefined</BankAccountType><BankName>sample string 14</BankName><BaseCardType>Undefined</BaseCardType><BatchNumber>10</BatchNumber><ClientReferenceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts"><d4p1:ClientReferenceData1>sample string 1</d4p1:ClientReferenceData1><d4p1:ClientReferenceData2>sample string 2</d4p1:ClientReferenceData2><d4p1:ClientReferenceData3>sample string 3</d4p1:ClientReferenceData3><d4p1:ClientReferenceData4>sample string 4</d4p1:ClientReferenceData4><d4p1:ClientReferenceData5>sample string 5</d4p1:ClientReferenceData5></ClientReferenceData><CreditCardExpirationMonth>1</CreditCardExpirationMonth><CreditCardExpirationYear>1</CreditCardExpirationYear><CreditCardType>Undefined</CreditCardType><CustomerId>sample string 17</CustomerId><CustomerName>sample string 12</CustomerName><InstanceName>sample string 11</InstanceName><InternalReferenceTransactionId>sample string 2</InternalReferenceTransactionId><LastFourDigits>sample string 7</LastFourDigits><OriginalAmount>3</OriginalAmount><PaymentDate>2019-11-19T10:52:09.7609159-08:00</PaymentDate><PostedAmount>4</PostedAmount><ProcessOneToken>sample string 13</ProcessOneToken><ReturnReasonCode>sample string 15</ReturnReasonCode><ReturnReasonType>Undefined</ReturnReasonType><RoutingNumber>sample string 8</RoutingNumber><TimeZone>sample string 6</TimeZone><TransactionId>sample string 1</TransactionId><TransactionStatus>Undefined</TransactionStatus><TransactionType>Undefined</TransactionType></TransactionInformation></Transactions></GetTransactionsByCustomerAndClientRefDataResponse>

Eft

POST api/Eft/Save

This operation tokenizes all the required information about a bank account payment method. Once the bank account information has been tokenized, you no longer have to provide us any sensitive and personal information to debit or credit a bank account, just use the token that is returned by our API.

SaveEftRequest

NameDescriptionTypeAdditional information
EftDetails

Eft details

EftDetails
ClientReferenceData

Client reference data

ClientReferenceData
CallbackId

A callback id associated to save EFT transaction

string
BypassBankAccountValidation

Bypassing bank account validation

boolean
CustomerId

A customer id associated with transaction

string
AccountGroupCode

This field is used to route money to different accounts based on a predefined groups.

string
AuthenticationKey

Instance authentication key

string

Required

EftDetails

NameDescriptionTypeAdditional information
RoutingNumber

The bank routing number. Must only contain numbers.

string

Required

AccountNumber

Account number. Must contain only numbers.

string

Required

Type

EFT account type - Checking / Savings.

EftAccountType
CustomerName

Customer name

string

Required

Request Formats

 
{
  "EftDetails": {
    "RoutingNumber": "123123123",
    "AccountNumber": "123123124",
    "Type": 0,
    "CustomerName": "John Stevens"
  },
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": "15474bcf-2151-4621-b183-e4791973fcef",
    "ClientReferenceData3": "Location",
    "ClientReferenceData4": null,
    "ClientReferenceData5": null
  },
  "CallbackId": null,
  "BypassBankAccountValidation": false,
  "CustomerId": null,
  "AccountGroupCode": null,
  "AuthenticationKey": "Authentication Key"
}
<SaveEftRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <AccountGroupCode i:nil="true" />
  <BypassBankAccountValidation>false</BypassBankAccountValidation>
  <CallbackId i:nil="true" />
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2>15474bcf-2151-4621-b183-e4791973fcef</d2p1:ClientReferenceData2>
    <d2p1:ClientReferenceData3>Location</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4 i:nil="true" />
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <CustomerId i:nil="true" />
  <EftDetails>
    <AccountNumber>123123124</AccountNumber>
    <CustomerName>John Stevens</CustomerName>
    <RoutingNumber>123123123</RoutingNumber>
    <Type>Undefined</Type>
  </EftDetails>
</SaveEftRequest>

Response Information

SaveEftResponse

NameDescriptionTypeAdditional information
Token

Saved Eft token

string
BankName

Bank name

string
ServerReferenceData

Additional response data

ServerReferenceData
TimeZone

Short time zone name with daylight saving time suffix

string
TokenCreationTime

Token creation date and time in merchant time zone

date
ResponseCode

Operation response code

string
Message

Response message

string

ServerReferenceData

NameDescriptionTypeAdditional information
ServerReferenceData1

Operation result description

string

Response Formats

{
  "Token": "7d4e097f-49fc-4a94-b8eb-c8c0da36d41e",
  "BankName": null,
  "ServerReferenceData": null,
  "TimeZone": null,
  "TokenCreationTime": null,
  "ResponseCode": "Success",
  "Message": "Success"
}
<SaveEftResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <BankName i:nil="true" />
  <ServerReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts" i:nil="true" />
  <TimeZone i:nil="true" />
  <Token>7d4e097f-49fc-4a94-b8eb-c8c0da36d41e</Token>
  <TokenCreationTime i:nil="true" />
</SaveEftResponse>

POST api/Eft/Credit

This operation allows to credit a given bank account, which initiates a transfer of money from the merchant to a particular customer bank account. You can either provide a bank account information or use a previously saved token.

CreditEftRequest

NameDescriptionTypeAdditional information
Amount

Amount to charge

decimal number

Required

Token

Saved Eft token

string
EftDetails

Eft details

EftDetails

Required, if Token field is not specified

ClientReferenceData

Client reference data

ClientReferenceData
IsRecurring

Is recurring charge

boolean
CallbackId

Callback ID

string
CustomerId

A customer id associated with transaction

string
AccountGroupCode

This field is used to route money to different accounts based on a predefined groups.

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "Amount": 100.0,
  "Token": null,
  "EftDetails": {
    "RoutingNumber": "123123123",
    "AccountNumber": "123123124",
    "Type": 0,
    "CustomerName": "John Stevens"
  },
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": "48b33de5-6fb5-477f-b1ef-7eaf4325155e",
    "ClientReferenceData3": "Location",
    "ClientReferenceData4": null,
    "ClientReferenceData5": null
  },
  "IsRecurring": false,
  "CallbackId": null,
  "CustomerId": null,
  "AccountGroupCode": null,
  "AuthenticationKey": "Authentication Key"
}
<CreditEftRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <AccountGroupCode i:nil="true" />
  <Amount>100</Amount>
  <CallbackId i:nil="true" />
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2>48b33de5-6fb5-477f-b1ef-7eaf4325155e</d2p1:ClientReferenceData2>
    <d2p1:ClientReferenceData3>Location</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4 i:nil="true" />
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <CustomerId i:nil="true" />
  <EftDetails>
    <AccountNumber>123123124</AccountNumber>
    <CustomerName>John Stevens</CustomerName>
    <RoutingNumber>123123123</RoutingNumber>
    <Type>Undefined</Type>
  </EftDetails>
  <IsRecurring>false</IsRecurring>
  <Token i:nil="true" />
</CreditEftRequest>

Response Information

CreditEftResponse

NameDescriptionTypeAdditional information
BankName

Bank name

string
TransactionId

Transaction ID

string
TransactionDate

Transaction date and time

date
TimeZone

Transaction time zone

string
BatchNumber

Number of the batch

integer
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "BankName": "Bank name",
  "TransactionId": "6dd8bc5e-3499-4556-864f-c391c21b609b",
  "TransactionDate": "2019-11-19T10:52:10",
  "TimeZone": "PST",
  "BatchNumber": 0,
  "ResponseCode": "Success",
  "Message": "Success"
}
<CreditEftResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <BankName>Bank name</BankName>
  <BatchNumber>0</BatchNumber>
  <TimeZone>PST</TimeZone>
  <TransactionDate>2019-11-19T10:52:10</TransactionDate>
  <TransactionId>6dd8bc5e-3499-4556-864f-c391c21b609b</TransactionId>
</CreditEftResponse>

POST api/Eft/Debit

This operation allows debiting a given bank account, which initiates a transfer of money from a particular customer bank account to the merchant. You can either provide a bank account information or use a previously saved token.

DebitEftRequest

NameDescriptionTypeAdditional information
Save

Enables to save and tokenize eft information

boolean
ChargeFee

Should we charge with fee

boolean
ConvenienceFeeType

Customizable convenience fee type that is matched with different types of transactions

string
BypassBankAccountValidation

Bypassing bank account validation

boolean
TransactionOrigination

Establishes transaction origination to define Standard Entry Class (SEC) code type for Automated Clearing House (ACH) File

TransactionOrigination
Amount

Amount to charge

decimal number

Required

Token

Saved Eft token

string
EftDetails

Eft details

EftDetails

Required, if Token field is not specified

ClientReferenceData

Client reference data

ClientReferenceData
IsRecurring

Is recurring charge

boolean
CallbackId

Callback ID

string
CustomerId

A customer id associated with transaction

string
AccountGroupCode

This field is used to route money to different accounts based on a predefined groups.

string
AuthenticationKey

Instance authentication key

string

Required

TransactionOrigination

Possible enumeration values:

NameValueDescription
Undefined

0

Transaction Origination is undefined

WEB

1

Reoccurring payment, means authorization was provided over the internet

PPD

2

Prearranged Payment and Deposit Entry

Request Formats

 
{
  "Save": false,
  "ChargeFee": false,
  "ConvenienceFeeType": null,
  "BypassBankAccountValidation": false,
  "TransactionOrigination": null,
  "Amount": 100.0,
  "Token": null,
  "EftDetails": {
    "RoutingNumber": "123123123",
    "AccountNumber": "123123124",
    "Type": 0,
    "CustomerName": "John Stevens"
  },
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": "f5c6d53d-0514-45ac-9b43-700c0d32fea6",
    "ClientReferenceData3": "Location",
    "ClientReferenceData4": null,
    "ClientReferenceData5": null
  },
  "IsRecurring": false,
  "CallbackId": null,
  "CustomerId": null,
  "AccountGroupCode": null,
  "AuthenticationKey": "Authentication Key"
}
<DebitEftRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <AccountGroupCode i:nil="true" />
  <Amount>100</Amount>
  <CallbackId i:nil="true" />
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2>f5c6d53d-0514-45ac-9b43-700c0d32fea6</d2p1:ClientReferenceData2>
    <d2p1:ClientReferenceData3>Location</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4 i:nil="true" />
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <CustomerId i:nil="true" />
  <EftDetails>
    <AccountNumber>123123124</AccountNumber>
    <CustomerName>John Stevens</CustomerName>
    <RoutingNumber>123123123</RoutingNumber>
    <Type>Undefined</Type>
  </EftDetails>
  <IsRecurring>false</IsRecurring>
  <Token i:nil="true" />
  <BypassBankAccountValidation>false</BypassBankAccountValidation>
  <ChargeFee>false</ChargeFee>
  <ConvenienceFeeType i:nil="true" />
  <Save>false</Save>
  <TransactionOrigination i:nil="true" />
</DebitEftRequest>

Response Information

DebitEftResponse

NameDescriptionTypeAdditional information
Token

ProcessOne payment token

string
ServerReferenceData

Additional response data

ServerReferenceData
BankName

Bank name

string
TransactionId

Transaction ID

string
TransactionDate

Transaction date and time

date
TimeZone

Transaction time zone

string
BatchNumber

Number of the batch

integer
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "Token": null,
  "ServerReferenceData": null,
  "BankName": "Bank name",
  "TransactionId": "99991",
  "TransactionDate": "2019-11-19T10:52:10",
  "TimeZone": "PST",
  "BatchNumber": 0,
  "ResponseCode": "Success",
  "Message": "Success"
}
<DebitEftResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <BankName>Bank name</BankName>
  <BatchNumber>0</BatchNumber>
  <TimeZone>PST</TimeZone>
  <TransactionDate>2019-11-19T10:52:10</TransactionDate>
  <TransactionId>99991</TransactionId>
  <ServerReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts" i:nil="true" />
  <Token i:nil="true" />
</DebitEftResponse>

POST api/Eft/Void

This operation provides a way to void or cancel a previously made EFT payment that has not been fully processed yet. If a payment was already processed, a refund operation is required. You have to provide the transaction id of a transaction that you want to void. You can include a callback id if you prefer to get the information about a void transaction record by the callback id.

VoidEftRequest

NameDescriptionTypeAdditional information
TransactionId

Transaction ID

string

Required

CallbackId

Callback ID

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "TransactionId": "99991",
  "CallbackId": null,
  "AuthenticationKey": "Authentication Key"
}
<VoidEftRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CallbackId i:nil="true" />
  <TransactionId>99991</TransactionId>
</VoidEftRequest>

Response Information

VoidEftResponse

NameDescriptionTypeAdditional information
TransactionId

string
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "TransactionId": null,
  "ResponseCode": "Success",
  "Message": "Success"
}
<VoidEftResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <TransactionId i:nil="true" />
</VoidEftResponse>

POST api/Eft/Refund

This operation provides a way to refund a previously made EFT payment that has been fully processed. To initiate a refund, call this API operation and provide a valid transaction id. You can include a callback id if you prefer to get the information about the refund transaction record by the callback id. Note: As payment transactions cannot be refunded until after they have been settled, if the batch has not yet closed for the transaction id in the refund request, the system will automatically Void the payment.

RefundEftRequest

NameDescriptionTypeAdditional information
TransactionId

Transaction ID to refund

string

Required

CallbackId

CallBack ID

string
PartialRefundAmount

Amount to refund

decimal number
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "TransactionId": "99991",
  "CallbackId": null,
  "PartialRefundAmount": 10.0,
  "AuthenticationKey": "Authentication Key"
}
<RefundEftRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <CallbackId i:nil="true" />
  <PartialRefundAmount>10</PartialRefundAmount>
  <TransactionId>99991</TransactionId>
</RefundEftRequest>

Response Information

RefundEftResponse

NameDescriptionTypeAdditional information
TransactionId

Transaction ID

string
BatchNumber

integer
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "TransactionId": null,
  "BatchNumber": 0,
  "ResponseCode": "Success",
  "Message": "Success"
}
<RefundEftResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <BatchNumber>0</BatchNumber>
  <TransactionId i:nil="true" />
</RefundEftResponse>

POST api/Eft/VerifyBankAccount

This operation provides a way to verify the validity of a bank account information. Verification of bank account ensures that our customers have valid bank information before authorizing payments. This also prevents users from inputting incorrect bank account number.

VerifyBankAccountRequest

NameDescriptionTypeAdditional information
EftDetails

EFT details

EftDetails
Token

Saved Eft Token

string
ClientReferenceData

Client reference data

ClientReferenceData
CustomerId

A customer id associated with transaction

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "EftDetails": {
    "RoutingNumber": "122199983",
    "AccountNumber": "92361077941",
    "Type": 0,
    "CustomerName": "John Stevens"
  },
  "Token": null,
  "ClientReferenceData": {
    "ClientReferenceData1": "1234",
    "ClientReferenceData2": "77e4ff48-9bb9-4efe-b55f-e0856f3b111e",
    "ClientReferenceData3": "Location",
    "ClientReferenceData4": null,
    "ClientReferenceData5": null
  },
  "CustomerId": null,
  "AuthenticationKey": "Authentication Key"
}
<VerifyBankAccountRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <ClientReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">
    <d2p1:ClientReferenceData1>1234</d2p1:ClientReferenceData1>
    <d2p1:ClientReferenceData2>77e4ff48-9bb9-4efe-b55f-e0856f3b111e</d2p1:ClientReferenceData2>
    <d2p1:ClientReferenceData3>Location</d2p1:ClientReferenceData3>
    <d2p1:ClientReferenceData4 i:nil="true" />
    <d2p1:ClientReferenceData5 i:nil="true" />
  </ClientReferenceData>
  <CustomerId i:nil="true" />
  <EftDetails>
    <AccountNumber>92361077941</AccountNumber>
    <CustomerName>John Stevens</CustomerName>
    <RoutingNumber>122199983</RoutingNumber>
    <Type>Undefined</Type>
  </EftDetails>
  <Token i:nil="true" />
</VerifyBankAccountRequest>

Response Information

VerifyBankAccountResponse

NameDescriptionTypeAdditional information
ServerReferenceData

Additional response data

ServerReferenceData
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "ServerReferenceData": null,
  "ResponseCode": "Success",
  "Message": "Success"
}
<VerifyBankAccountResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <ServerReferenceData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts" i:nil="true" />
</VerifyBankAccountResponse>

POST api/Eft/GetBankData

This operation provides information about the bank that is associated with the provided routing number. If a non-existing routing number is provided in the request, the API will respond with an appropriate error message.

GetBankDataRequest

NameDescriptionTypeAdditional information
RoutingNumber

The bank routing number. Must only contain numbers.

string

Required

AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "RoutingNumber": "123123123",
  "AuthenticationKey": "Authentication Key"
}
<GetBankDataRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Authentication Key</AuthenticationKey>
  <RoutingNumber>123123123</RoutingNumber>
</GetBankDataRequest>

Response Information

GetBankDataResponse

NameDescriptionTypeAdditional information
Description

Description

string
BankName

Name of Bank based of Routing Number.

string
BankAddress

Bank Institution Address.

string
BankCity

City Name of Bank Institution.

string
BankState

State of Bank.

string
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "Description": null,
  "BankName": "Test Bank",
  "BankAddress": "test address",
  "BankCity": "Test city",
  "BankState": "State",
  "ResponseCode": "Success",
  "Message": "Success"
}
<GetBankDataResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">Success</ResponseCode>
  <BankAddress>test address</BankAddress>
  <BankCity>Test city</BankCity>
  <BankName>Test Bank</BankName>
  <BankState>State</BankState>
  <Description i:nil="true" />
</GetBankDataResponse>

POST api/Eft/GetConvenienceFee

This operation returns the EFT convenience fee amount that corresponds to the specified fee type and dollar amount. If fee type is not provided, the API will return the default convenience fee type for your merchant. Convenience fee types vary from merchant to merchant and have to be addressed during contract negotiation.

ConvenienceFeeRequest

NameDescriptionTypeAdditional information
Amount

Charge amount

decimal number
ConvenienceFeeType

Convenience fee type

string
AuthenticationKey

Instance authentication key

string

Required

Request Formats

 
{
  "Amount": 1.0,
  "ConvenienceFeeType": "sample string 1",
  "AuthenticationKey": "sample string 2"
}
<ConvenienceFeeRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <AuthenticationKey xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 2</AuthenticationKey>
  <Amount>1</Amount>
  <ConvenienceFeeType>sample string 1</ConvenienceFeeType>
</ConvenienceFeeRequest>

Response Information

ConvenienceFeeResponse

NameDescriptionTypeAdditional information
ConvenienceFee

Convenience fee

decimal number
CalculationType

Fee calculation type for current fee tier

string
FlatRate

Flat rate for fee tier, applicable for CalculationType = FlatRate

decimal number
Percent

Percent rate for fee tier, applicable for CalculationType = Percent

decimal number
MinimumAmount

Minimum fee amount, applicable for CalculationType = Percent

decimal number
ResponseCode

Operation response code

string
Message

Response message

string

Response Formats

{
  "ConvenienceFee": 1.0,
  "CalculationType": "sample string 2",
  "FlatRate": 1.0,
  "Percent": 1.0,
  "MinimumAmount": 1.0,
  "ResponseCode": "sample string 3",
  "Message": "sample string 4"
}
<ConvenienceFeeResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts.Eft">
  <Message xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 4</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/OneInc.ProcessOne.RestApi.Contracts.DataContracts">sample string 3</ResponseCode>
  <CalculationType>sample string 2</CalculationType>
  <ConvenienceFee>1</ConvenienceFee>
  <FlatRate>1</FlatRate>
  <MinimumAmount>1</MinimumAmount>
  <Percent>1</Percent>
</ConvenienceFeeResponse>

Test Data

You can use the following card numbers for testing purposes.

Card Type Card number Cvv2 Expiration date Comments
Visa 4111111111111111 Any 3 digit Any future date
MasterCard 5431111111111111 Any 3 digit Any future date See available amount combinations below.
Discover 6011601160116611 Any 3 digit Any future date See available amount combinations below.
AmericanExpress 341111111111111 Any 4 digit Any future date See available amount combinations below.
Hybrid Visa PinlessDebit Star 4024007167282317 Any 3 digit Any future date This is as a Hybrid Visa card. If your Merchant is provisioned for Pinless Debit cards, the card will process as a pinless debit Star. If your merchant account is not setup for Pinless Debit, it will process as a Visa
Hybrid Discover PinlessDebit Pulse 6011172923498605 Any 3 digit Any future date This is as a Hybrid Discover card. If your Merchant is provisioned for Pinless Debit cards, the card will process as a pinless debit Pulse. If your merchant account is not setup for Pinless Debit, it will process as a Discover
Hybrid MasterCard PinlessDebit Nyce 5384483278305365 Any 3 digit Any future date This is as a Hybrid Mastercard. If your Merchant is provisioned for Pinless Debit cards, the card will process as a pinless debit Nyce. If your merchant account is not setup for Pinless Debit, it will process as a Mastercard

Use the following card number and amount combination to simulate different API response codes.

Card number Amount Response Code Description
4444444444444448
5431111111111111
341111111111111
6011601160116611
1.00 or any not listed amount Success Test: Charge approved
4444444444444448
5431111111111111
341111111111111
6011601160116611
2.00 or 12.00 IncorrectValidationValue Test: CVV2 code is invalid
4444444444444448
5431111111111111
341111111111111
6011601160116611
3.00 or 13.00 Declined Test: Declined
4444444444444448
5431111111111111
341111111111111
6011601160116611
4.00 OverMaximumPayment Test: Exceed max payment amount
4444444444444448
5431111111111111
341111111111111
6011601160116611
5.00 or 15.00 DuplicateTransaction Test: Duplicate transaction
4444444444444448
5431111111111111
341111111111111
6011601160116611
6.00 or 16.00 GatewayInternalError Test: System is down
4444444444444448
5431111111111111
341111111111111
6011601160116611
7.00 or 17.00 InvalidCardNumber Test: Invalid card number returned by gateway
4444444444444448
5431111111111111
341111111111111
6011601160116611
14.00 AvsVerificationFailed Test: Avs verification failed
4444444444444448
5431111111111111
341111111111111
6011601160116611
18.00 Call Test: Issuer wants voice contact with cardholder
4444444444444448
5431111111111111
341111111111111
6011601160116611
19.00 NoProcessorResponse Test: No response from Processor

Use the following card numbers to simulate specific API response codes regardless of amount.

Test Data for Save transaction type.
Card number Response Code Description
4444444444444117 Success Test: Successfully saved
Test Data for Charge transaction type.
Card number Response Code Description
4444444444444125 Success Test: Charge approved
4444444444444133 IncorrectValidationValue Test: CVV2 code is invalid
4444444444444141 Declined Test: Insufficient funds
4444444444444158 OverMaximumPayment Test: Amount sent exceeds maximum allowable amount.
4444444444444166 DuplicateTransaction Test: Duplicate transaction
4444444444444174 GatewayInternalError Test: System is down
4444444444444182 InvalidCardNumber Test: Invalid card number returned by gateway
4444444444444190 Success Test: Charge approved
4444444444444208 IncorrectValidationValue Test: CVV2 code is invalid
4444444444444216 Declined Test: Insufficient funds
4444444444444224 AvsVerificationFailed Test: Avs verification failed
4444444444444232 DuplicateTransaction Test: Duplicate transaction
4444444444444240 GatewayInternalError Test: System is down
4444444444444257 InvalidCardNumber Test: Invalid card number returned by gateway
4444444444444265 Call Test: Issuer wants voice contact with cardholder
4444444444444273 NoProcessorResponse Test: No response from Processor
Test Data for Charge transaction type (for subsequent void / refund).
Card number Response Code Description
4444444444444299 Success Test: Charge approved
4444444444444307 Success Test: Charge approved
4444444444444315 Success Test: Charge approved
4444444444444323 Success Test: Charge approved
4444444444444331 Success Test: Charge approved
4444444444444349 Success Test: Charge approved
4444444444444356 Success Test: Charge approved
4444444444444364 Success Test: Charge approved
4444444444444372 Success Test: Charge approved
4444444444444380 Success Test: Charge approved
4444444444444398 Success Test: Charge approved
4444444444444505 Success Test: Charge approved
4444444444444513 Success Test: Charge approved
Test Data for void / refund transaction type.
Card number Response Code Description
4444444444444299 InvalidCardNumber Test: This is an invalid card number or account is closed
4444444444444307 IncorrectValidationValue Test: CVV2 code is invalid
4444444444444315 Declined Test: Insufficient funds
4444444444444323 InvalidCreditCardAmount Test: Amount sent exceeds maximum allowable amount.
4444444444444331 DuplicateTransaction Test: Duplicate transaction
4444444444444349 GatewayInternalError Test: System is down
4444444444444356 AvsVerificationFailed Test: Avs Verification Failed
4444444444444364 CardTypeNotAccepted Test: The card type provided is not supported
4444444444444372 CardExpired Test: The Card is Expired
4444444444444380 Call Test: Issuer wants voice contact with cardholder
4444444444444398 NoProcessorResponse Test: No response from Processor
4444444444444505 Success Test: Refund successful
4444444444444513 Success Test: Void successful

You can use the following EFT data for testing purposes.

Account Number Routing Number Account Type
123456789 121042882 Checking

Use the following bank account number and amount combination to simulate different API response codes.

Test Data for Credit and Debit transaction types.
Account Number Amount Response Code Description
1234567890 $0.00 Success Test: Successfully saved
1234567890 $1.00 Success Test: Transaction approved
1234567890 $2.00 ACHTransactionFailed Test: Not able to process bank account payment
1234567890 $3.00 GatewayInternalError Test: System is down
1234567890 $4.00 NoProcessorResponse Test: No response from Processor
Test Data for Void and Refund transaction types. You can only void or refund an already existing transaction.
Account Number Amount Response Code Description
1234567890 $11.00 ACHTransactionFailed Test: Not able to process bank account payment
1234567890 $12.00 GatewayInternalError Test: System is down
1234567890 $13.00 NoProcessorResponse Test: No response from Processor

Use the following bank account number to simulate specific API response codes regardless of amount.

Transaction Type Account Number Response Code Description
SaveEft 1234567891 Success Test: Successfully saved
Credit or Debit 1234567892 Success Test: Bank account transaction is successfully approved
Credit or Debit 1234567893 ACHTransactionFailed Test: Not able to process bank account payment
Credit or Debit 1234567894 GatewayInternalError Test: System is down
Credit or Debit 1234567895 NoProcessorResponse Test: No response from Processor
Credit or Debit for subsequent Void or refund 1234567896 Success Test: Bank account transaction is successfully approved
Credit or Debit for subsequent Void or refund 1234567897 Success Test: Bank account transaction is successfully approved
Credit or Debit for subsequent Void or refund 1234567898 Success Test: Bank account transaction is successfully approved
Void or Refund 1234567896 ACHTransactionFailed Test: Not able to process bank account payment
Credit or Debit for subsequent Void or refund 1234567897 GatewayInternalError Test: System is down
Credit or Debit for subsequent Void or refund 1234567898 NoProcessorResponse Test: No response from Processor

You can use the following EFT data to simulate Bank Account Validation response codes.

For testing, any valid routing number shall be used. The results will depend on bank account number.
Account Number Response Code Description
1234567890 Success Test: Charge approved
2234567890 InvalidAccountNumber Test: Invalid Account Number
3234567890 InvalidRoutingNumber Test: Invalid Routing Number
4234567890 GatewayInternalError Test: System is down

Response Code Definitions

Response Code Description Applicable Methods
Success Indicates a successful transaction. All
InvalidAuthenticationKey Invalid Authentication Key. This key will be assigned to you by One Inc. All
MerchantDisabled Your Merchant account is disabled. All
IncorrectValidationValue The CVV2 code is invalid. ChargeCreditCard | ChargeCreditCardNoFee
AvsVerificationFailed AVS failed. ChargeCreditCard | ChargeCreditCardNoFee
IncorrectTransactionId Indicates that the transactionID that you are sending for a refund or void is not a valid transaction or cannot be found. GetTokenInfo | RefundCreditCard | RefundEFT | UpdateCreditCard | UpdateTransactionMetadata | VoidCreditCard | VoidEFT
InvalidCardNumber This is an invalid card number. Can also indicate that this is a closed account. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | VerifyCreditCard
CardExpired The Card is Expired. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | VerifyCreditCard
MaxAllowablePaymentsExceeded Maximum Allowable payments exceeded for policy or account. ChargeCreditCard | ChargeCreditCardNoFee | DebitEFT | DebitEFTWithFee
CardTypeNotAccepted The card type provided is not supported. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | VerifyCreditCard
Declined The transaction was declined by the issuing bank. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | VerifyCreditCard
Call Indicates that the merchant should call the issuing bank. It is likely fraud. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | VerifyCreditCard
GatewayInternalError This generic error can happen for different reasons. The error description will contain more detailed information as to the core of the problem. All
InvalidRoutingNumber You have sent in an invalid Routing Number. GetBankData | CreditEFT | DebitEFT | DebitEFTWithFee | SaveEFT | VerifyBankAccount
InvalidAccountNumber You have sent in an invalid Account Number. CreditEFT | DebitEFT | DebitEFTWithFee | SaveEFT | VerifyBankAccount
BlockedBankAccount This bank account has been blocked due to past failed payments. DebitEFT | DebitEFTWithFee | SaveEFT
InvalidEFTAmount Amount must be greater than $0. CreditEFT | DebitEFT | DebitEFTWithFee | GetEftConvenienceFee
EFTCustomerNameMissing When processing an EFT, you must supply the customer name or you will receive this error. CreditEFT | DebitEFT | DebitEFTWithFee | SaveEFT
CreditCardCustomerNameMissing When saving a credit card you must provide the customer name. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | VerifyCreditCard
ACHTransactionFailed Returned when an error returns for processing EFTDebit transactions. CreditEFT | DebitEFT | DebitEFTWithFee
CreditCardVoidFailed The voiding of the credit card transaction has failed. VoidCreditCard
CreditCardVoidFailed The voiding of the credit card transaction has failed. VoidCreditCard
BatchHasBeenClosed This error message is returned when you attempt to void a transaction when the batch has already been closed. VoidCreditCard | VoidEFT
OverMaximumPayment Payment Amount has exceeded maximum allowed. ChargeCreditCard | ChargeCreditCardNoFee | CreditEFT | DebitEFT | DebitEFTWithFee
InvalidCreditCardAmount You have sent in an invalid amount for credit card transaction. Usually occurs when sending in a zero dollar amount. ChargeCreditCard | ChargeCreditCardNoFee | GetCreditCardConvenienceFeeAmount | RefundCreditCard
DuplicateTransaction A duplicate payment has been entered into the system with the same Amount, Last 4, PolicyNumber (ClientRefData1) in the configured specified amount of time. Default is 2 min but this can be changed. Please contact support team to change this amount. ChargeCreditCard | ChargeCreditCardNoFee | CreditEFT | DebitEFT | DebitEFTWithFee | RefundCreditCard
InvalidZipcode An invalid zip code was passed. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | UpdateCreditCard | VerifyCreditCard
InvalidExpirationDate An invalid expiration date was passed. ChargeCreditCard | ChargeCreditCardNoFee | SaveCreditCard | UpdateCreditCard | VerifyCreditCard
UnableToRefundTransaction Transaction has already been refunded. RefundCreditCard | RefundEFT
PartialRefundIsNotAllowed Your merchant is not setup to process partial refunds. Please reach out to the support team if you would like this feature enabled. RefundCreditCard
InvalidPartialRefundAmount An attempt was made to refund more than the original payment. RefundCreditCard
BatchHasNotBeenClosed You have attempted to refund a payment but the batch has not closed. You should void payment instead. RefundCreditCard
NoProcessorResponse An attempt to authorize a card through the card network has timed out. You should try again. All
OperationNotSupportedByGateway This error may occur when trying to execute operation with incorrect settings. VerifyCreditCard
OperationNotSupportedByMerchant This error may occur when trying to execute operation which is currently disabled for merchant. VerifyBankAccount, VerifyCreditCard