SPIn REST API Methods

Base URL

Production:

https://api.spinpos.net

SandBox:

https://test.spinpos.net/spin

Was this section helpful?

What made this section unhelpful for you?

Sale

Sale is the most common request that user to do payment on a terminal.

All the responses have GeneralResponse section that informs about successful result or error. See Error Codes and Messages.

Body Parameters

Amountnumber (double)Required

Total amount of the transaction.

TipAmountnumber (double)

Tip amount of the transaction.

ExternalReceiptstring

Text in receipt format that terminal prints as a part of terminal receipt

PaymentTypestring Required

Indicates electronic data capture (EDC) type.

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
PrintReceiptstring

Indicates if any of receipt copies should be printed after the transaction.

Enum values:
NoBothMerchantCustomer
GetReceiptstring

Indicates if any of receipt copies should be returned in response.

Enum values:
NoBothMerchantCustomer
MerchantNumberinteger (int32)

Merchant number for multi-merchant environment. If not present in multi-merchant environment, transaction will be cancelled.

Minimum
1
Maximum
5
InvoiceNumberstring

Unique alphanumeric invoice number.

Max length
50
CaptureSignatureboolean

Indicates whether customer signature should be captured or not in course of transaction.

GetExtendedDataboolean

Indicates whether extended transaction data should be returned or not.

CallbackInfoobject

Information for callback with transaction result.

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for payment request

Show child attributes

PaymentTypestring

Indicates electronic data capture ['Credit', 'Debit', 'EBT', 'Card'].

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionTypestring

Indicates Transaction Type (Sale, Void, Auth, etc).

Amountsobject

Show child attributes

AuthCodestring

Authorization code provided by payment processor.

ReferenceIdstring

Alphanumeric unique SPin transaction identifier.

InvoiceNumberstring

Unique invoice number.

SerialNumberstring

Device Serial Number.

BatchNumberstring

Current batch number.

TransactionNumberstring

Transaction number within batch.

Voidedboolean

Indicates whether transaction was voided or not.

Signaturestring

Indicates customer signature if it was captured.

IPosTokenstring

Using the token obtained in sale response POS can perform new authorisation using "Transact"”" api of iPosPays. This sale request will not require any card interaction at the payment device.

Tokenstring

This token could be required for future transactions using the same card

RRNstring

Reference Retrieval Number provided by iPOSPay Gateway. Uses for iPos gateway Api.

ExtendedDataByApplicationobject
CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Receiptsobject

Show child attributes

DvPay
Object
DvPay and Aura response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

Show child attributes

DvPay Lite
Object
DvPay Lite response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
IPosTokenstring
RRNstring
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Error
Object
Sample of error reponse

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

PaymentTypestring
TransactionTypestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
Voidedboolean
RRNstring
ExtendedDataByApplicationarray

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

POST

/v2/Payment/Sale

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 curl --location 'https://api.spinpos.net/v2/Payment/Sale' \ --data '{ "Amount": 1, "TipAmount": null, "ExternalReceipt": "", "PaymentType": "Credit", "ReferenceId": "d6c871b6a580", "PrintReceipt": "No", "GetReceipt": "No", "MerchantNumber": null, "InvoiceNumber": "", "CaptureSignature": false, "GetExtendedData": true, "CallbackInfo": { "Url": "" }, "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "HostResponseCode": "",
    "HostResponseMessage": "",
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  },
  "PaymentType": "Credit",
  "TransactionType": "",
  "Amounts": {
    "TotalAmount": null,
    "Amount": null,
    "TipAmount": null,
    "FeeAmount": null,
    "TaxAmount": null
  },
  "AuthCode": "",
  "ReferenceId": "",
  "InvoiceNumber": "",
  "SerialNumber": "",
  "BatchNumber": "",
  "TransactionNumber": "",
  "Voided": false,
  "Signature": "",
  "IPosToken": "",
  "Token": "",
  "RRN": "",
  "ExtendedDataByApplication": {},
  "CardData": {
    "CardType": "None",
    "EntryType": "None",
    "Last4": "",
    "First4": "",
    "BIN": "",
    "ExpirationDate": "",
    "Name": ""
  },
  "EMVData": {
    "ApplicationName": "",
    "AID": "",
    "TVR": "",
    "TSI": "",
    "IAD": "",
    "ARC": ""
  },
  "Receipts": {
    "Customer": "",
    "Merchant": ""
  }
}
Was this section helpful?

What made this section unhelpful for you?

Return

Return is an independent operation and it does not relate to any Sale transaction. Please use a unique ReferenceID for Return request. You may do return on any amount. For a terminal app Return operation is not related to any Sale that you did in the past. Return does charge back and behaves as Sale only vice-versa and add money on card balance.

Body Parameters

Amountnumber (double)Required

Total amount of the transaction.

PaymentTypestring Required

Indicates electronic data capture (EDC) type.

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
PrintReceiptstring

Indicates if any of receipt copies should be printed after the transaction.

Enum values:
NoBothMerchantCustomer
GetReceiptstring

Indicates if any of receipt copies should be returned in response.

Enum values:
NoBothMerchantCustomer
MerchantNumberinteger (int32)

Merchant number for multi-merchant environment. If not present in multi-merchant environment, transaction will be cancelled.

Minimum
1
Maximum
5
InvoiceNumberstring

Unique alphanumeric invoice number.

Max length
50
CaptureSignatureboolean

Indicates whether customer signature should be captured or not in course of transaction.

GetExtendedDataboolean

Indicates whether extended transaction data should be returned or not.

CallbackInfoobject

Information for callback with transaction result.

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for payment request

Show child attributes

PaymentTypestring

Indicates electronic data capture ['Credit', 'Debit', 'EBT', 'Card'].

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionTypestring

Indicates Transaction Type (Sale, Void, Auth, etc).

Amountsobject

Show child attributes

AuthCodestring

Authorization code provided by payment processor.

ReferenceIdstring

Alphanumeric unique SPin transaction identifier.

InvoiceNumberstring

Unique invoice number.

SerialNumberstring

Device Serial Number.

BatchNumberstring

Current batch number.

TransactionNumberstring

Transaction number within batch.

Voidedboolean

Indicates whether transaction was voided or not.

Signaturestring

Indicates customer signature if it was captured.

IPosTokenstring

Using the token obtained in sale response POS can perform new authorisation using "Transact"”" api of iPosPays. This sale request will not require any card interaction at the payment device.

Tokenstring

This token could be required for future transactions using the same card

RRNstring

Reference Retrieval Number provided by iPOSPay Gateway. Uses for iPos gateway Api.

ExtendedDataByApplicationobject
CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Receiptsobject

Show child attributes

DvPay
Object
DvPay and AURA response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

Show child attributes

DvPay Lite
Object
DvPay Lite response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
IPosTokenstring
RRNstring
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

Show child attributes

POST

/v2/Payment/Return

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 curl --location 'https://api.spinpos.net/v2/Payment/Return' \ --data '{ "Amount": 1, "PaymentType": "Credit", "ReferenceId": "3ecebccef5d4", "PrintReceipt": "No", "GetReceipt": "No", "MerchantNumber": null, "InvoiceNumber": "3", "CaptureSignature": false, "GetExtendedData": true, "CallbackInfo": { "Url": "" }, "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "HostResponseCode": "",
    "HostResponseMessage": "",
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  },
  "PaymentType": "Credit",
  "TransactionType": "",
  "Amounts": {
    "TotalAmount": null,
    "Amount": null,
    "TipAmount": null,
    "FeeAmount": null,
    "TaxAmount": null
  },
  "AuthCode": "",
  "ReferenceId": "",
  "InvoiceNumber": "",
  "SerialNumber": "",
  "BatchNumber": "",
  "TransactionNumber": "",
  "Voided": false,
  "Signature": "",
  "IPosToken": "",
  "Token": "",
  "RRN": "",
  "ExtendedDataByApplication": {},
  "CardData": {
    "CardType": "None",
    "EntryType": "None",
    "Last4": "",
    "First4": "",
    "BIN": "",
    "ExpirationDate": "",
    "Name": ""
  },
  "EMVData": {
    "ApplicationName": "",
    "AID": "",
    "TVR": "",
    "TSI": "",
    "IAD": "",
    "ARC": ""
  },
  "Receipts": {
    "Customer": "",
    "Merchant": ""
  }
}
Was this section helpful?

What made this section unhelpful for you?

Void

Void operation cancels operation that it is referring to. Void need to do before Settlement. You cannot do Void after Settlement in this case you will need to do Return.

Insert line aboveInsert line belowDelete

Void may be done for Sale, Return, Auth, Capture requests.

Insert line aboveInsert line belowDelete

To do void you need to know ReferenceID and amount of transaction that you void.

Body Parameters

Amountnumber (double)Required

Total amount of the transaction.

PaymentTypestring Required

Indicates electronic data capture (EDC) type.

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
PrintReceiptstring

Indicates if any of receipt copies should be printed after the transaction.

Enum values:
NoBothMerchantCustomer
GetReceiptstring

Indicates if any of receipt copies should be returned in response.

Enum values:
NoBothMerchantCustomer
MerchantNumberinteger (int32)

Merchant number for multi-merchant environment. If not present in multi-merchant environment, transaction will be cancelled.

Minimum
1
Maximum
5
CaptureSignatureboolean

Indicates whether customer signature should be captured or not in course of transaction.

GetExtendedDataboolean

Indicates whether extended transaction data should be returned or not.

CallbackInfoobject

Information for callback with transaction result.

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for payment request

Show child attributes

PaymentTypestring

Indicates electronic data capture ['Credit', 'Debit', 'EBT', 'Card'].

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionTypestring

Indicates Transaction Type (Sale, Void, Auth, etc).

Amountsobject

Show child attributes

AuthCodestring

Authorization code provided by payment processor.

ReferenceIdstring

Alphanumeric unique SPin transaction identifier.

InvoiceNumberstring

Unique invoice number.

SerialNumberstring

Device Serial Number.

BatchNumberstring

Current batch number.

TransactionNumberstring

Transaction number within batch.

Voidedboolean

Indicates whether transaction was voided or not.

Signaturestring

Indicates customer signature if it was captured.

IPosTokenstring

Using the token obtained in sale response POS can perform new authorisation using "Transact"”" api of iPosPays. This sale request will not require any card interaction at the payment device.

Tokenstring

This token could be required for future transactions using the same card

RRNstring

Reference Retrieval Number provided by iPOSPay Gateway. Uses for iPos gateway Api.

ExtendedDataByApplicationobject
CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Receiptsobject

Show child attributes

DvPay
Object
DvPay and AURA response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
ExtendedDataByApplicationarray

Show child attributes

CardDataobject

Show child attributes

EMVDataobject
DvPay Lite
Object
DvPay Lite response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
IPosTokenstring
RRNstring
CardDataobject

Show child attributes

EMVDataobject

POST

/v2/Payment/Void

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 curl --location 'https://api.spinpos.net/v2/Payment/Void' \ --data '{ "Amount": 1, "PaymentType": "Credit", "ReferenceId": "d6c871b6a580", "PrintReceipt": "No", "GetReceipt": "No", "MerchantNumber": null, "CaptureSignature": false, "GetExtendedData": true, "CallbackInfo": { "Url": "" }, "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "HostResponseCode": "",
    "HostResponseMessage": "",
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  },
  "PaymentType": "Credit",
  "TransactionType": "",
  "Amounts": {
    "TotalAmount": null,
    "Amount": null,
    "TipAmount": null,
    "FeeAmount": null,
    "TaxAmount": null
  },
  "AuthCode": "",
  "ReferenceId": "",
  "InvoiceNumber": "",
  "SerialNumber": "",
  "BatchNumber": "",
  "TransactionNumber": "",
  "Voided": false,
  "Signature": "",
  "IPosToken": "",
  "Token": "",
  "RRN": "",
  "ExtendedDataByApplication": {},
  "CardData": {
    "CardType": "None",
    "EntryType": "None",
    "Last4": "",
    "First4": "",
    "BIN": "",
    "ExpirationDate": "",
    "Name": ""
  },
  "EMVData": {
    "ApplicationName": "",
    "AID": "",
    "TVR": "",
    "TSI": "",
    "IAD": "",
    "ARC": ""
  },
  "Receipts": {
    "Customer": "",
    "Merchant": ""
  }
}
Was this section helpful?

What made this section unhelpful for you?

Tip Adjust

Body Parameters

Amountnumber (double)Required

Total amount of the transaction.

TipAmountnumber (double)Required
PaymentTypestring Required

Indicates electronic data capture (EDC) type.

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
MerchantNumberinteger (int32)

Merchant number for multi-merchant environment. If not present in multi-merchant environment, transaction will be cancelled.

Minimum
1
Maximum
5
GetExtendedDataboolean

Indicates whether extended transaction data should be returned or not.

CallbackInfoobject

Information for callback with transaction result.

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for payment request

Show child attributes

PaymentTypestring

Indicates electronic data capture ['Credit', 'Debit', 'EBT', 'Card'].

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionTypestring

Indicates Transaction Type (Sale, Void, Auth, etc).

Amountsobject

Show child attributes

AuthCodestring

Authorization code provided by payment processor.

ReferenceIdstring

Alphanumeric unique SPin transaction identifier.

InvoiceNumberstring

Unique invoice number.

SerialNumberstring

Device Serial Number.

BatchNumberstring

Current batch number.

TransactionNumberstring

Transaction number within batch.

Voidedboolean

Indicates whether transaction was voided or not.

Signaturestring

Indicates customer signature if it was captured.

IPosTokenstring

Using the token obtained in sale response POS can perform new authorisation using "Transact"”" api of iPosPays. This sale request will not require any card interaction at the payment device.

Tokenstring

This token could be required for future transactions using the same card

RRNstring

Reference Retrieval Number provided by iPOSPay Gateway. Uses for iPos gateway Api.

ExtendedDataByApplicationobject
CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Receiptsobject

Show child attributes

DvPay
Object
DvPay and AURA response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject
DvPay Lite
Object
DvPay Lite response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
RRNstring
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject
Error
Object

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
BatchNumberstring
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

POST

/v2/Payment/TipAdjust

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 curl --location 'https://api.spinpos.net/v2/Payment/TipAdjust' \ --data '{ "Amount": 1, "TipAmount": 1, "PaymentType": "Credit", "ReferenceId": "d6c871b6a580", "MerchantNumber": null, "GetExtendedData": true, "CallbackInfo": { "Url": "" }, "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "HostResponseCode": "",
    "HostResponseMessage": "",
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  },
  "PaymentType": "Credit",
  "TransactionType": "",
  "Amounts": {
    "TotalAmount": null,
    "Amount": null,
    "TipAmount": null,
    "FeeAmount": null,
    "TaxAmount": null
  },
  "AuthCode": "",
  "ReferenceId": "",
  "InvoiceNumber": "",
  "SerialNumber": "",
  "BatchNumber": "",
  "TransactionNumber": "",
  "Voided": false,
  "Signature": "",
  "IPosToken": "",
  "Token": "",
  "RRN": "",
  "ExtendedDataByApplication": {},
  "CardData": {
    "CardType": "None",
    "EntryType": "None",
    "Last4": "",
    "First4": "",
    "BIN": "",
    "ExpirationDate": "",
    "Name": ""
  },
  "EMVData": {
    "ApplicationName": "",
    "AID": "",
    "TVR": "",
    "TSI": "",
    "IAD": "",
    "ARC": ""
  },
  "Receipts": {
    "Customer": "",
    "Merchant": ""
  }
}
Was this section helpful?

What made this section unhelpful for you?

Auth

Body Parameters

Amountnumber (double)Required

Total amount of the transaction.

PaymentTypestring Required

Indicates electronic data capture (EDC) type.

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
PrintReceiptstring

Indicates if any of receipt copies should be printed after the transaction.

Enum values:
NoBothMerchantCustomer
GetReceiptstring

Indicates if any of receipt copies should be returned in response.

Enum values:
NoBothMerchantCustomer
MerchantNumberinteger (int32)

Merchant number for multi-merchant environment. If not present in multi-merchant environment, transaction will be cancelled.

Minimum
1
Maximum
5
InvoiceNumberstring

Unique alphanumeric invoice number.

Max length
50
CaptureSignatureboolean

Indicates whether customer signature should be captured or not in course of transaction.

GetExtendedDataboolean

Indicates whether extended transaction data should be returned or not.

CallbackInfoobject

Information for callback with transaction result.

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for payment request

Show child attributes

PaymentTypestring

Indicates electronic data capture ['Credit', 'Debit', 'EBT', 'Card'].

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionTypestring

Indicates Transaction Type (Sale, Void, Auth, etc).

Amountsobject

Show child attributes

AuthCodestring

Authorization code provided by payment processor.

ReferenceIdstring

Alphanumeric unique SPin transaction identifier.

InvoiceNumberstring

Unique invoice number.

SerialNumberstring

Device Serial Number.

BatchNumberstring

Current batch number.

TransactionNumberstring

Transaction number within batch.

Voidedboolean

Indicates whether transaction was voided or not.

Signaturestring

Indicates customer signature if it was captured.

IPosTokenstring

Using the token obtained in sale response POS can perform new authorisation using "Transact"”" api of iPosPays. This sale request will not require any card interaction at the payment device.

Tokenstring

This token could be required for future transactions using the same card

RRNstring

Reference Retrieval Number provided by iPOSPay Gateway. Uses for iPos gateway Api.

ExtendedDataByApplicationobject
CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Receiptsobject

Show child attributes

DvPay
Object
DvPay and AURA response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

Show child attributes

DvPay Lite
Object
DvPay Lite response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
IPosTokenstring
RRNstring
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

Show child attributes

POST

/v2/Payment/Auth

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 curl --location 'https://api.spinpos.net/v2/Payment/Auth' \ --data '{ "Amount": 1, "PaymentType": "Credit", "ReferenceId": "0122dcfa7829", "PrintReceipt": "No", "GetReceipt": "No", "MerchantNumber": null, "InvoiceNumber": "", "CaptureSignature": false, "GetExtendedData": true, "CallbackInfo": { "Url": "" }, "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "HostResponseCode": "",
    "HostResponseMessage": "",
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  },
  "PaymentType": "Credit",
  "TransactionType": "",
  "Amounts": {
    "TotalAmount": null,
    "Amount": null,
    "TipAmount": null,
    "FeeAmount": null,
    "TaxAmount": null
  },
  "AuthCode": "",
  "ReferenceId": "",
  "InvoiceNumber": "",
  "SerialNumber": "",
  "BatchNumber": "",
  "TransactionNumber": "",
  "Voided": false,
  "Signature": "",
  "IPosToken": "",
  "Token": "",
  "RRN": "",
  "ExtendedDataByApplication": {},
  "CardData": {
    "CardType": "None",
    "EntryType": "None",
    "Last4": "",
    "First4": "",
    "BIN": "",
    "ExpirationDate": "",
    "Name": ""
  },
  "EMVData": {
    "ApplicationName": "",
    "AID": "",
    "TVR": "",
    "TSI": "",
    "IAD": "",
    "ARC": ""
  },
  "Receipts": {
    "Customer": "",
    "Merchant": ""
  }
}
Was this section helpful?

What made this section unhelpful for you?

Capture

Body Parameters

Amountnumber (double)Required

Total amount of the transaction.

TipAmountnumber (double)

Tip amount of the transaction.

AuthCodestring

Authorization code provided by payment processor.

PaymentTypestring Required

Indicates electronic data capture (EDC) type.

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
PrintReceiptstring

Indicates if any of receipt copies should be printed after the transaction.

Enum values:
NoBothMerchantCustomer
GetReceiptstring

Indicates if any of receipt copies should be returned in response.

Enum values:
NoBothMerchantCustomer
MerchantNumberinteger (int32)

Merchant number for multi-merchant environment. If not present in multi-merchant environment, transaction will be cancelled.

Minimum
1
Maximum
5
InvoiceNumberstring

Unique alphanumeric invoice number.

Max length
50
CaptureSignatureboolean

Indicates whether customer signature should be captured or not in course of transaction.

GetExtendedDataboolean

Indicates whether extended transaction data should be returned or not.

CallbackInfoobject

Information for callback with transaction result.

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for payment request

Show child attributes

PaymentTypestring

Indicates electronic data capture ['Credit', 'Debit', 'EBT', 'Card'].

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionTypestring

Indicates Transaction Type (Sale, Void, Auth, etc).

Amountsobject

Show child attributes

AuthCodestring

Authorization code provided by payment processor.

ReferenceIdstring

Alphanumeric unique SPin transaction identifier.

InvoiceNumberstring

Unique invoice number.

SerialNumberstring

Device Serial Number.

BatchNumberstring

Current batch number.

TransactionNumberstring

Transaction number within batch.

Voidedboolean

Indicates whether transaction was voided or not.

Signaturestring

Indicates customer signature if it was captured.

IPosTokenstring

Using the token obtained in sale response POS can perform new authorisation using "Transact"”" api of iPosPays. This sale request will not require any card interaction at the payment device.

Tokenstring

This token could be required for future transactions using the same card

RRNstring

Reference Retrieval Number provided by iPOSPay Gateway. Uses for iPos gateway Api.

ExtendedDataByApplicationobject
CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Receiptsobject

Show child attributes

DvPay
Object
DvPay and AURA response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject
DvPay Lite
Object
DvPay Lite response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
IPosTokenstring
RRNstring
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

POST

/v2/Payment/Capture

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 curl --location 'https://api.spinpos.net/v2/Payment/Capture' \ --data '{ "Amount": 10, "TipAmount": null, "AuthCode": "AXS854", "PaymentType": "Credit", "ReferenceId": "0122dcfa7829", "PrintReceipt": "No", "GetReceipt": "No", "MerchantNumber": null, "InvoiceNumber": "", "CaptureSignature": false, "GetExtendedData": true, "CallbackInfo": { "Url": "" }, "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "HostResponseCode": "",
    "HostResponseMessage": "",
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  },
  "PaymentType": "Credit",
  "TransactionType": "",
  "Amounts": {
    "TotalAmount": null,
    "Amount": null,
    "TipAmount": null,
    "FeeAmount": null,
    "TaxAmount": null
  },
  "AuthCode": "",
  "ReferenceId": "",
  "InvoiceNumber": "",
  "SerialNumber": "",
  "BatchNumber": "",
  "TransactionNumber": "",
  "Voided": false,
  "Signature": "",
  "IPosToken": "",
  "Token": "",
  "RRN": "",
  "ExtendedDataByApplication": {},
  "CardData": {
    "CardType": "None",
    "EntryType": "None",
    "Last4": "",
    "First4": "",
    "BIN": "",
    "ExpirationDate": "",
    "Name": ""
  },
  "EMVData": {
    "ApplicationName": "",
    "AID": "",
    "TVR": "",
    "TSI": "",
    "IAD": "",
    "ARC": ""
  },
  "Receipts": {
    "Customer": "",
    "Merchant": ""
  }
}
Was this section helpful?

What made this section unhelpful for you?

Status

Body Parameters

TransactionNumberinteger (int32)

The number of transaction wants to retrieve.

Minimum
1
Maximum
9999
PaymentTypestring Required

Indicates electronic data capture (EDC) type.

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
PrintReceiptstring

Indicates if any of receipt copies should be printed after the transaction.

Enum values:
NoBothMerchantCustomer
GetReceiptstring

Indicates if any of receipt copies should be returned in response.

Enum values:
NoBothMerchantCustomer
MerchantNumberinteger (int32)

Merchant number for multi-merchant environment. If not present in multi-merchant environment, transaction will be cancelled.

Minimum
1
Maximum
5
CaptureSignatureboolean

Indicates whether customer signature should be captured or not in course of transaction.

GetExtendedDataboolean

Indicates whether extended transaction data should be returned or not.

CallbackInfoobject

Information for callback with transaction result.

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for payment request

Show child attributes

PaymentTypestring

Indicates electronic data capture ['Credit', 'Debit', 'EBT', 'Card'].

Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionTypestring

Indicates Transaction Type (Sale, Void, Auth, etc).

Amountsobject

Show child attributes

AuthCodestring

Authorization code provided by payment processor.

ReferenceIdstring

Alphanumeric unique SPin transaction identifier.

InvoiceNumberstring

Unique invoice number.

SerialNumberstring

Device Serial Number.

BatchNumberstring

Current batch number.

TransactionNumberstring

Transaction number within batch.

Voidedboolean

Indicates whether transaction was voided or not.

Signaturestring

Indicates customer signature if it was captured.

IPosTokenstring

Using the token obtained in sale response POS can perform new authorisation using "Transact"”" api of iPosPays. This sale request will not require any card interaction at the payment device.

Tokenstring

This token could be required for future transactions using the same card

RRNstring

Reference Retrieval Number provided by iPOSPay Gateway. Uses for iPos gateway Api.

ExtendedDataByApplicationobject
CardDataobject

Show child attributes

EMVDataobject

Show child attributes

Receiptsobject

Show child attributes

DvPay
Object
DvPay and AURA response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

Show child attributes

DvPay Lite
Object
DvPay Lite response example

Response Attributes

Amountsobject

Show child attributes

GeneralResponseobject

Show child attributes

PaymentTypestring
TransactionTypestring
AuthCodestring
ReferenceIdstring
InvoiceNumberstring
SerialNumberstring
BatchNumberstring
TransactionNumberstring
Voidedboolean
RRNstring
ExtendedDataByApplicationobject

Show child attributes

CardDataobject

Show child attributes

EMVDataobject

POST

/v2/Payment/Status

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 curl --location 'https://api.spinpos.net/v2/Payment/Status' \ --data '{ "TransactionNumber": null, "PaymentType": "Credit", "ReferenceId": "", "PrintReceipt": "No", "GetReceipt": "No", "MerchantNumber": null, "CaptureSignature": false, "GetExtendedData": false, "CallbackInfo": { "Url": "" }, "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "HostResponseCode": "",
    "HostResponseMessage": "",
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  },
  "PaymentType": "Credit",
  "TransactionType": "",
  "Amounts": {
    "TotalAmount": null,
    "Amount": null,
    "TipAmount": null,
    "FeeAmount": null,
    "TaxAmount": null
  },
  "AuthCode": "",
  "ReferenceId": "",
  "InvoiceNumber": "",
  "SerialNumber": "",
  "BatchNumber": "",
  "TransactionNumber": "",
  "Voided": false,
  "Signature": "",
  "IPosToken": "",
  "Token": "",
  "RRN": "",
  "ExtendedDataByApplication": {},
  "CardData": {
    "CardType": "None",
    "EntryType": "None",
    "Last4": "",
    "First4": "",
    "BIN": "",
    "ExpirationDate": "",
    "Name": ""
  },
  "EMVData": {
    "ApplicationName": "",
    "AID": "",
    "TVR": "",
    "TSI": "",
    "IAD": "",
    "ARC": ""
  },
  "Receipts": {
    "Customer": "",
    "Merchant": ""
  }
}
Was this section helpful?

What made this section unhelpful for you?

Status List

Body Parameters

PaymentTypestring Required
Enum values:
CreditDebitEBT_FoodEBT_CashCardCashCheckGift
TransactionFromIndexinteger (int32)Required
Minimum
1
Maximum
5000
TransactionToIndexinteger (int32)Required
Minimum
1
Maximum
5000
Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

Transactionsarray

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Payment/StatusList

Select
1 2 3 4 5 6 7 8 9 10 curl --location 'https://api.spinpos.net/v2/Payment/StatusList' \ --data '{ "PaymentType": "Credit", "TransactionFromIndex": null, "TransactionToIndex": null, "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "Transactions": {},
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Summary Report

Body Parameters

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720

Responses

DvPay
Object
DvPay and AURA response example

Response Attributes

SummaryDetailsarray

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

DvPay Lite
Object
DvPay Lite response example

Response Attributes

SummaryDetailsarray

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Report/Summary

Select
1 2 3 4 5 6 curl --location 'https://api.spinpos.net/v2/Report/Summary' \ --data '{ "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null }'

Response

{
  "SummaryDetails": [
    {
      "Application": "DvCredit",
      "TransactionsSummaryReports": {
        "TransactionsCount": 6,
        "SaleAmount": 12.1,
        "ReturnAmount": -1,
        "VoidAmount": -1.05,
        "AuthAmount": 1,
        "TotalAmount": 21.55
      }
    },
    {
      "Application": "DvCash"
    },
    {
      "Application": "2"
    }
  ],
  "GeneralResponse": {
    "ResultCode": "0",
    "StatusCode": "0000",
    "Message": "Success",
    "DetailedMessage": "Success"
  }
}
Was this section helpful?

What made this section unhelpful for you?

Daily Report

Body Parameters

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720

Responses

DvPay
Object
DvPay and AURA response example

Response Attributes

DailyDetailsarray

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

DvPay Lite
Object
DvPay Lite respopnse example

Response Attributes

DailyDetailsarray

Show child attributes

GeneralResponseobject

Show child attributes

POST

/v2/Report/Daily

Select
1 2 3 4 5 6 curl --location 'https://api.spinpos.net/v2/Report/Daily' \ --data '{ "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null }'

Response

{
  "DailyDetails": [
    {
      "Application": "DvCredit",
      "TotalAmount": 21.55,
      "TransactionsDailyReports": [
        {
          "Number": 1,
          "ReferenceId": "1",
          "CardType": "M/C",
          "TransactionType": "SL",
          "Last4": "4111",
          "Amount": 1.05
        },
        {
          "Number": 2,
          "ReferenceId": "2",
          "CardType": "M/C",
          "TransactionType": "SL",
          "Last4": "4111",
          "Amount": 11.05
        },
        {
          "Number": 3,
          "ReferenceId": "3",
          "CardType": "AMX",
          "TransactionType": "RT",
          "Last4": "1006",
          "Amount": -1
        },
        {
          "Number": 4,
          "ReferenceId": "",
          "CardType": "M/C",
          "TransactionType": "VS",
          "Last4": "4111",
          "Amount": -1.05
        },
        {
          "Number": 5,
          "ReferenceId": "4",
          "CardType": "AMX",
          "TransactionType": "AU",
          "Last4": "1006",
          "Amount": 1
        },
        {
          "Number": 6,
          "ReferenceId": "4",
          "CardType": "AMX",
          "TransactionType": "TK",
          "Last4": "1006",
          "Amount": 10.5
        },
        {
          "Number": 1,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 2,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 3,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 4,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 5,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 6,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 20.2
        },
        {
          "Number": 7,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 20.2
        },
        {
          "Number": 8,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 20.2
        },
        {
          "Number": 9,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 10,
          "CardType": "Csh",
          "TransactionType": "RT",
          "Last4": "    ",
          "Amount": -100
        },
        {
          "Number": 1,
          "TransactionType": "Redeem",
          "Amount": 10
        },
        {
          "Number": 2,
          "TransactionType": "Void  ",
          "Amount": 10
        }
      ]
    },
    {
      "Application": "DvCash",
      "TotalAmount": 278.8,
      "TransactionsDailyReports": [
        {
          "Number": 1,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 2,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 3,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 4,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 5,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 6,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 20.2
        },
        {
          "Number": 7,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 20.2
        },
        {
          "Number": 8,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 20.2
        },
        {
          "Number": 9,
          "CardType": "Csh",
          "TransactionType": "SL",
          "Last4": "    ",
          "Amount": 19.7
        },
        {
          "Number": 10,
          "CardType": "Csh",
          "TransactionType": "RT",
          "Last4": "    ",
          "Amount": -100
        }
      ]
    },
    {
      "Application": "DvGift",
      "TotalAmount": null,
      "TransactionsDailyReports": [
        {
          "Number": 1,
          "TransactionType": "Redeem",
          "Amount": 10
        },
        {
          "Number": 2,
          "TransactionType": "Void  ",
          "Amount": 10
        }
      ]
    }
  ],
  "GeneralResponse": {
    "ResultCode": "0",
    "StatusCode": "0000",
    "Message": "Success",
    "DetailedMessage": "Success"
  }
}
Was this section helpful?

What made this section unhelpful for you?

Settle

Body Parameters

ReferenceIdstring
GetReceiptboolean
SettlementTypestring

The field indicating the type of settlement processing. Standard close, remove all batch data, or settle without validation.

Enum values:
CloseClearForce
Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

SettleDetailsarray

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

DvPay
Object
DvPay and AURA response examples

Response Attributes

SettleDetailsarray

Show child attributes

GeneralResponseobject

General response for any request

Show child attributes

DvPay Lite
Object
DvPay Lite response examples

Response Attributes

SettleDetailsarray

Show child attributes

GeneralResponseobject

Show child attributes

POST

/v2/Payment/Settle

Select
1 2 3 4 5 6 7 8 9 10 curl --location 'https://api.spinpos.net/v2/Payment/Settle' \ --data '{ "ReferenceId": "30e5bd83f508", "GetReceipt": false, "SettlementType": "Close", "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "SettleDetails": {},
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Abort Transaction

Body Parameters

ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Payment/AbortTransaction

Select
1 2 3 4 5 6 7 curl --location 'https://api.spinpos.net/v2/Payment/AbortTransaction' \ --data '{ "ReferenceId": "", "Tpn": "", "Authkey": "", "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Printer

Body Parameters

Printerstring Required
Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Common/Printer

Select
1 2 3 4 5 6 7 8 curl --location 'https://api.spinpos.net/v2/Common/Printer' \ --data '{ "Printer": "<L>Test text format</L> <L>Normal text</L> <LG> <L>Large Text</L> </LG> <INV> <L>Inverted text</L> </INV> <CD> <L>Condensed text</L> </CD> <B> <L>Bold text</L> </B> <INV> <LG> <L>Large Inverted text</L> </LG> </INV> <CD> <LG> <L>Large Condensed text</L> </LG> </CD> <LG> <B> <L>Large Bold text</L> </B> </LG> <INV> <B> <L>Bold Inverted text</L> </B> </INV> <CD> <B> <L>Bold Condensed text</L> </B> </CD> <BR /> <L>Text alignment</L> <L>Left text</L> <C>Center text</C> <R>Right text</R> <L>Left text</L> <R>Right text</R> <BR /> <L>Image</L> <IMG>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</IMG> <BR /> <L>Line Width</L> <L>123456789012345678901234567890</L> <BR /> <L>QR code</L> <QR>https://app.theneo.io/dejavoo/spin</QR> <BR /> <L>Feed</L> <BR /> <BR /> <BR /> <BR /> <BR /> <BR /> <BR /> <BR />", "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Get Signature

Prompts a dialog on terminal to draw a signature on terminal screen.

Body Parameters

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

Signaturestring

Indicates customer signature.

GeneralResponseobject

General response for any request

Show child attributes

DvPay Lite
Object
BadRequest

Response Attributes

Signaturestring
GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Common/GetSignature

Select
1 2 3 4 5 6 7 curl --location 'https://api.spinpos.net/v2/Common/GetSignature' \ --data '{ "Tpn": "z11invtest69", "Authkey": "JZiRUusizc", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "Signature": "iVBORw0KGgoAAAANSUhEUgAAAV4AAABkCAYAAADOvVhlAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAVkSURBVHhe7d3NihxVFADgPIKrwCRTlckL+ADqC7gTJODChYILUZe6C1mKIrpwoy7MQkVcuIkoCv6BCP4sFBWCoqIgZpOQYBIzJJOJnjOe1p6kzWT6t6rn++DSfW/1dFfVPffUrZ6amn0AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACwR6ytrf2VpWmazWoCYBYOHTq0lXDzsZoAmKZIsNcGs9u2bT+tZgCmaTCrrZnt+9UMwLQ0TXM0k+zBgwffGiTcWgTAtGRybdt2Y2Vl5ZBkCzAD1yfXoa8TbqsmACYRs9mLo2ax1ydgACaQCTWvQqjqNrHsioQLMKGY1V7dKZnGa45IuABjiiT60m6SaL42ZsC/VBWAnUTSPD3ObLUS7sivHAC4TibNKGNfaRA/K+EC3EzMTN8eZ1Y7yrTeB2Cp5Gw2E+Tq6urd1TSxSN5XorhLGMBAJtq2bS9UdaryvTOZV5UlFjF0Kg6wgz982VayPZZvxAH9g3r5LYmf2boyJsvKysr91Qz9E4Pg9Qzkqs5EfMZHs/4M5mOQ+Kq6cJGM/xBb9EIGagTsJ1WdqfqsV6tKD2WsVMLt9NmKBEyn5ICpBHiimubCQOi36L/Uqz7s2/qyZDIA4xT/h6rOVXzu1Shnq0rPROyc72sCi7jLuL9cVZitCLYzXRgsuQ55+8aq0iMRQ+f6mnAH+r7+9EAGWQyW9aounKDvp4ihC8vQd23bXm2a5ruqwvTkAInSqV9yRLA/KOn2T/TZ98vSb5F0z0X5saowmZiNfJiDI4LqSDV1SqzXG5Juv0RMHT98+PDS9Flsj6+3mFwmsj4ks0i6xyTd/oi+umeZEm4Sf4wtjtjPZABFIuvV91OCvh+in7YuJ4yyVk29F2PlUlfPAumwGgidvyj9/zRN82I9pcMyxuLA/lBVe6/+4emVqsLNRfBfy0EQR+m7qqnXclvqKR0U8XZy2fpIzHFLIvjXM1jyq4RqWgox233EIOim6JcHJFz2nAySZQ+UmLVfjIPJ+arSARFzg+9xl+bub8s+jphAzmYr4PfMf1PI7Y3tfqKqLFj1x5tV7bXYjseinKkq/CcCfbOC/Xg17Sm57fWUBYp++GJZ+kJMMVIGRpU9fyNvg2TxKhZ7fXmYOGKkCm7BMaRpmqP2yeLEvr8cZ1qduT/HbokdRhok2yj3VRND2rbdiIF/qqrMUf7VWcRl7864JFtGGkq2e/5rhJ0YRPMX+/y9Pu33ODB/naWq8I8I4sEvxy5VE7dI4p2vitPPqtpJuY5RTFq4UQVHBvFP1cQYch/WU2as4vWVqnaGGOCmhpLtx9XEhNq2/Tb2p4E3YxW3nTgji3XZrKcwWgTJ1j0RslQTU5b7tmmah6vKDCwqfuNz89pgN6FhZxmkg1JNzJh9PVvz2L9x9vKUfmRXBolW4CyOfT9b04zveJ8v9RdjGQSiAOqO/fv336E/5mcQ/zf7nj2W51U7/sU546mbHku2PZF9FAnBL2LmIPbz+drfj1XTv5qm2foF6PDYGS65rMpmlPW2bU9H+Sp+7uXV1dV74zULvzTswIEDd8Y6HYtyItbx1yh/Rtm4fluGSyzPv+r7OX7m6ai7vG0csQPzpuGO2j1Wg8EBcxci5p+vRLIZSfD2agYYXyWVTMjPVdNSigR6JLZxa1Y6tM3v1mKA7oiEdcPpZM6ao1yJZb/F4+fx+FqUF6I8GeVYnCI/ns9j2bMxS8xl78Tzk/H4ezyejbIeJU+rr0XZ9t6jSr4mSp62fhPv/WitGgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGyzb9/fkFbSL2Iw6OUAAAAASUVORK5CYII=",
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "OK",
    "DetailedMessage": "OK",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

User Choice

Body Parameters

Titlestring Required
Max length
32
ChoiceOptionsarray Required

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

SelectedOptionstring
GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Common/UserChoice

Select
1 2 3 4 5 6 7 8 9 curl --location 'https://api.spinpos.net/v2/Common/UserChoice' \ --data '{ "Title": "", "ChoiceOptions": {}, "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "SelectedOption": "",
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

User Input

Body Parameters

Titlestring Required
Timeoutinteger (int32)
MaxLengthinteger (int32)
HiddenInputboolean
Typestring Required
Enum values:
NumberLettersNumberAndLettersCurrencyInfoOnly
Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

InputedStringstring
GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Common/UserInput

Select
1 2 3 4 5 6 7 8 9 10 11 12 curl --location 'https://api.spinpos.net/v2/Common/UserInput' \ --data '{ "Title": "", "Timeout": null, "MaxLength": null, "HiddenInput": false, "Type": "Number", "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "InputedString": "",
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Disclaimer

Body Parameters

Titlestring Required
Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

Signaturestring

Indicates customer signature.

GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/Common/Disclaimer

Select
1 2 3 4 5 6 7 8 curl --location 'https://api.spinpos.net/v2/Common/Disclaimer' \ --data '{ "Title": "", "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "Signature": "",
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Terminal Connection Status

Query Parameters

request.tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
request.authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10

Responses

200
Object
OK

Response Attributes

TerminalStatusstring

Terminal status - Online, Offline, or Not Found

Enum values:
OfflineOnlineNotFound
Tpnstring

Terminal profile number.

ErrorDescriptionstring

Description of validations error for invalid request

400
Object
BadRequest

Response Attributes

TerminalStatusstring

Terminal status - Online, Offline, or Not Found

Enum values:
OfflineOnlineNotFound
Tpnstring

Terminal profile number.

ErrorDescriptionstring

Description of validations error for invalid request

404
Object
NotFound

Response Attributes

TerminalStatusstring

Terminal status - Online, Offline, or Not Found

Enum values:
OfflineOnlineNotFound
Tpnstring

Terminal profile number.

ErrorDescriptionstring

Description of validations error for invalid request

GET

/v2/Common/TerminalStatus?request.tpn=&request.authkey=

Select
1 curl --location 'https://api.spinpos.net/v2/Common/TerminalStatus?request.tpn=' \

Response

{
  "TerminalStatus": "Offline",
  "Tpn": "",
  "ErrorDescription": ""
}
Was this section helpful?

What made this section unhelpful for you?

Select Invoice

Body Parameters

Titlestring
InvoiceListarray Required

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

SelectedInvoiceIdstring
GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/TableApp/SelectInvoice

Select
1 2 3 4 5 6 7 8 9 curl --location 'https://api.spinpos.net/v2/TableApp/SelectInvoice' \ --data '{ "Title": "", "InvoiceList": {}, "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "SelectedInvoiceId": "",
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Payment Invoice

Body Parameters

ReferenceIdstring Required

Alphanumeric SPIn transaction identifier. Has to be unique within one batch.

Min length
1
Max length
50
InvoiceDataobject

Show child attributes

Tpnstring Required

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment.

Min length
10
Max length
12
Authkeystring

Merchant's authorization password. Required if no SPInToken.

Min length
10
Max length
10
SPInProxyTimeoutinteger (int32)

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Minimum
1
Maximum
720
CustomFieldsobject

A collection of custom fields in key-value format.

Responses

200
Object
OK

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

400
Object
BadRequest

Response Attributes

GeneralResponseobject

General response for any request

Show child attributes

POST

/v2/TableApp/PaymentInvoice

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 curl --location 'https://api.spinpos.net/v2/TableApp/PaymentInvoice' \ --data '{ "ReferenceId": "", "InvoiceData": { "Id": "", "Name": "", "TotalAmount": null, "PaidAmount": null, "Goods": {}, "Payments": {} }, "Tpn": "", "Authkey": "", "SPInProxyTimeout": null, "CustomFields": {} }'

Response

{
  "GeneralResponse": {
    "ResultCode": "Ok",
    "StatusCode": "Approved: 0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Gift

undefined

Receipt format

Tags

Description

DvPay

DvPay Lite

Aura

LG

Large Text

INV

Inverted text

CD

All text inside this tag will be formatted as condensed

B

All text inside this tag will be formatted as bold

BR

Extra line feed

C

 The text inside this tag will be horizontally centered

R

The text inside this tag will be aligned to the right. Use it for long text that takes few lines

L

The text inside this tag will be aligned to the left

IMG

This tag includes base64-encoded monochrome BMP or PNG image data in request. Response contents PNG

BMP only

QR

The text inside this tag will encoded and printed as QR code

POST

/

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 curl --location 'https://api.spinpos.net/' \ --data '{ "Printer": "<L>Test text format</L> <L>Normal text</L> <LG> <L>Large Text</L> </LG> <INV> <L>Inverted text</L> </INV> <CD> <L>Condensed text</L> </CD> <B> <L>Bold text</L> </B> <INV> <LG> <L>Large Inverted text</L> </LG> </INV> <CD> <LG> <L>Large Condensed text</L> </LG> </CD> <LG> <B> <L>Large Bold text</L> </B> </LG> <INV> <B> <L>Bold Inverted text</L> </B> </INV> <CD> <B> <L>Bold Condensed text</L> </B> </CD> <BR /> <L>Text alignment</L> <L>Left text</L> <C>Center text</C> <R>Right text</R> <L>Left text</L> <R>Right text</R> <BR /> <L>Image</L> <IMG>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</IMG> <BR /> <L>Line Width</L> <L>123456789012345678901234567890</L> <BR /> <L>QR code</L> <QR>https://app.theneo.io/dejavoo/spin</QR> <BR /> <L>Feed</L> <BR /> <BR /> <BR /> <BR /> <BR /> <BR /> <BR /> <BR />", "Tpn":"", "Authkey":"", "SPInProxyTimeout":125 }'
Was this section helpful?

What made this section unhelpful for you?

Signature

Signature that terminals returns is .PNG image coded in Base64 format.

Was this section helpful?

What made this section unhelpful for you?

Extended Data for Responses

Parameter

Comment

DvPay

DvPay Lite

AcntFirst4

first 4 digits of PAN

AcntLast4

last 4 digits of PAN

AcqRefData

long acquirer reference ID (used in Mercury/Vantiv processor).

Amount

reflects the transaction amount provided in SPin request.

AppName

application name (Settlement only)

AVSRsp

AVS response from the payment host

BatchNum

current batch number

BIN

BIN of the card

CardType

card type/processing network.

  • VISA
  • MASTERCARD
  • AMEX (American Express)
  • DISCOVER
  • PAYPAL
  • DINERSCLUB
  • JCB
  • CUP (China Union Pay)
  • ENROUTE
  • DEBIT
  • EBT

Cashback

cashback amount

ClerkId

clerk/server ID

ControlNum

fiscal control number

Cust1

custom prompt #1 title (see Cust1 field)

Cust1Value

value entered by used during #1 custom prompt

Cust2

custom prompt #2 title (see Cust2 field)

Cust2Value

value entered by used during #2 custom prompt

Cust3

custom prompt #3 title (see Cust3 field)

Cust3Value

value entered by used during #3 custom prompt

CVVRsp

CVV response from the payment host

DISC

debit discount amount

Donation

donation amount

EBTCashAvailBalance

EBT Cash available balance

EBTCashBeginBalance

EBT Cash begin balance

EBTCashLedgerBalance

EBT Cash ledger balance

EBTFSAvailBalance

EBT SNAP available balance

EBTFSBeginBalance

EBT SNAP begin balance

EBTFSLedgerBalance

EBT SNAP ledger balance

EntryType

entry method used to provide card data.

  • Swipe
  • Manual
  • CHIP
  • Specific
  • Contactless
  • CHIP Contactless
  • CHIP/Swipe (Fallback only)
  • CHIP/Manual (Fallback only)
  • CHIP Contactless/Swipe (Fallback only)
  • CHIP Contactless/Manual (Fallback only)

ExpDate

card expiry date

Fee

total fee amount

InvNum

transaction invoice number. If invoice number is missing, transaction number will be used instead

Language

transaction language.

  • English
  • French
  • Hebrew (AURA only)

Name

URL-encoded cardholder name

NumTrans

the number of transactions within batch (Settlement only)

Receipt

settlement report copy (Settlement copy, for more see Digital Receipt format)

RefNo

Mercury/Vantiv reference number

RewardCode

Loyalty promo code

RewardQR

Loyalty QR code

Rsp

response code (Settlement only)

  • 0 – success
  • 1 – failure

RwdBalance

Loyalty balance

RwdIssued

Loyalty reward issued

RwdPoints

Loyalty points acquired

SHFee

Service and Handling Fee, if enabled

Status

payment host response message (Settlement only)

SVC

debit surcharge amount

TableNum

table number

TaxAmount

commercial tax amount

TaxCity

fiscal city tax amount

TaxState

fiscal state tax amount

TicketNum

ticket number

Tip

tip amount

TipAmt

total tip amount (Settlement only)

TotalAmt

total transaction amount

Was this section helpful?

What made this section unhelpful for you?

Error Codes and Messages

Each response has section GeneralResponse section that informs about successful result or error with error code and description

It contents the next data

Parameter

Comment

HostResponseCode

This response code comes from the payment processor as is. It is usually referring to ISO 8583-1987.

HostResponseMessage

Meanings for host response code that comes from the payment processor as is. It is usually referring to ISO 8583-1987.

ResultCode

0 - success

1 - terminals error

2 spin prosy error

StatusCode

Shows specific 4-digit response code for specific situation or terminal statement

The are 3 basic sets of 4-digit codes depends on a side of spin transaction and a place where this message comes from and a result of transaction. Number of sets may be extended in the future. The logic close to HTTP Status Codes.

  • 0xxx - successful responses from terminal application. The response comes from a terminal application.
  • 1xxx - error responses from terminal app. The response was sent from a terminal.
  • 2xxx - error response from SPIN Proxy server. The response did not reach terminal or terminal did not provide a response in appropriate time.

List of possible status codes see below.

Message

Short message about response status

DetailedMessage

Text message in English that describes Status Code.

Register application may show this message or use StatusCode only and show their own messages for every StatusCode. For example if a register needs to show the messages not in English they may add translation for every code on their side.

DelayBeforeNextRequest

Time in seconds that recommended to wait before send next request. This returns when SPIn Proxy service is busy with previous request.

StatusCode list of values

0xxx - Successful responses from terminal application

Status Code

Detailed Message

Description

0000

Approved

The transaction or a service request was approved

0001

Partial Approval

  • The transaction was partially approved by the host
  • One or more (but not all) applications approved the settlement request

NOTE: On the test host for partial approval you need to make a sale with $50 base amount and $2 tips - TSYS (depends on the host)

1xxx - Error responses from terminal app

Status Code

Detailed Message

Description

1000

Terminal Busy

  • The terminal is busy processing another SPIN request
  • The terminal is in SPIN bypass mode

1001

Not Found

  • Get Parameter or Set Parameter service could not find requested parameters
  • Status request could not find a matching transaction record
  • Void request could not find a matching transaction record
  • Tip Adjustment request could not find a matching transaction record
  • Get request could not find matching transaction records
  • TSYS level 3 request could not find a matching transaction record

1002

Not Implemented

  • Unsupported service requested (Invoice, GetCard, etc.)

1003

Not Supported

  • Get PIN service request could not find a proper payment application
  • Tip Adjustment request could not find a proper payment application
  • Upload SnF request could not find a proper payment application
  • Batch Report request could not find a proper payment application
  • Disclaimer service requested on a terminal with no touch capability

1004

Not Allowed

  • A Void Auth requested for a processor that does not allow Void Auth
  • A non-EBT voucher transaction requested
  • A manual Debit card entry attempted and the processor is not BridgePay
  • A tip amount is sent in an Auth request
  • A custom fee is sent in an Auth or EBT request

1005

Low Battery

  • Battery charge is low

NOTE: not implemented on Android devices)

1006

Internal Error

  • Printer service requested when the terminal is out of paper
  • Unexpected internal terminal error happened

1007

Format Error

  • The SPIN request uses an unsupported markup language or the request is malformed

1008

Wrong Payment Or Transaction Type

  • The transaction request uses incorrect or inapplicable payment or transaction type

1009

Authentication Failed

  • Authentication failed (auth key mismatch). Usually this means need to pull parameters on a terminal or check that register sends correct AuthKey.

1010

Missing Reference ID

  • The reference ID is missing in a request that requires it

1011

Duplicate Reference ID

  • A transaction with a requested reference ID already exists in the batch

1012

Cancelled

  • User cancelled the transaction or it was interrupted for an unknown reason

1013

Bad Request

  • Incorrect printer service request
  • User Choice service request has no nested items to choose from
  • User Input service request does not specify the input type
  • Software Download service request is missing one or more mandatory parameters
  • Load Key or Delete Key service request is missing one or more mandatory parameters
  • A transaction request has no payment or transaction type
  • 0 amount requested for an unapplicable transaction
  • Amount length is invalid
  • Invalid ATM amount for PointOfBanking or BridgePay
  • A tip amount is sent when tip is disabled or in "on percent" mode
  • Cashback amount of 0 entered by the user when terminal is configured for a non-zero cashback
  • Fee, tip and cashback amounts are greater than the total amount of the transaction
  • Invalid clerk ID requested
  • Tip Adjustment request has no amount, tip or reference ID
  • Get request is missing range parameters
  • Get request has an invalid range
  • TSYS level 3 request has no auth code

1014

Communication Error

  • Communication error with a third party host occurred

1015

Declined

  • Load Key or Delete Key request failed
  • Settlement requested with no payment applications installed
  • A transaction is declined offline or by the host
  • A settlement request is declined by the host

1016

Payment Type Mismatch

  • Payment type of the transaction is not applicable for the card

1017

Incorrect Merchant ID

  • Invalid merchant ID specified in request

1018

PINpad Communication Error

  • A communication error with the PINpad device occurred

1019

No Debit Keys Loaded

  • An encrypted PIN was requested by the transaction, but the terminal has no keys loaded

1020

No Open Batch

  • No application that has an open batch during a settlement request

1021

Pending SnF Transaction

  • Settlement has been requested, but the terminal is in SnF mode and has pending transactions to upload

1022

Untipped Transactions Remain

  • Settlement has been requested, but the terminal is in restaurant mode and has untipped transactions

1023

Open Tab

  • Settlement has been requested, but the terminal has an open tab

20xx - Error response from SPIN Proxy Server

Status Code

Detailed Message

Description

2001

Terminal not connected to SPIn Proxy server

  • need to check that terminal has connection to the Internet and to SPIn proxy and shows that it is ready for transaction

2002

Active AuthKey not found

  • AuthKey in request does is wrong or does not exists. Usually this means misprint in AuthKey

2003

Register not found

  • TPN wrong or does not exists
  • Possible that the request goes to wrong server test instead of prod or vice-versa

2004

Route not found

  • TPN does not have configuration for SPIn proxy

2005

Active route not found

  • Connection was blocked on server side
  • Terminal is not active
  • Two or more devices used the same TPN

2006

Not pars request

  • Invalid request it may happen if self extra space in some values

2007

The operation has timed out

  • Terminal did not provide response during timeout time. Default timeout is 120 seconds. Settlement default timeout is 420 seconds

2008

Terminal in use

  • Terminal operate previous request in this case API returns DelayBeforeNextRequest in GeneralResponse as a recommendation to specify time when timeout will happen.

2009

Transaction not found

2010

Communication error

2011

Terminal is not available

21xx - Error response from SPIN Proxy Server Async Requests with Call-back

Status Code

Detailed Message

Description

2101

Callback Url was not specified

2102

Invalid XML document

2110

Internal exception

Responses

200
Object

Response Attributes

GeneralResponseobject

Show child attributes

400
Object

Response Attributes

GeneralResponseobject

Show child attributes

Response

{
  "GeneralResponse": {
    "HostResponseCode": "00",
    "HostResponseMessage": "APPROVAL-Approved and Completed",
    "ResultCode": "0",
    "StatusCode": "0000",
    "Message": "Approved",
    "DetailedMessage": "APPROVAL VTLMC1",
    "DelayBeforeNextRequest": null
  }
}
Was this section helpful?

What made this section unhelpful for you?

Transaction types scheme

Description: scheme describes how which transaction types can apply to original transaction, for example you can't do Void and Tip adjust without sale (Sale root)

Sale root:

Refund/Return root:

Auth - capture root:

Was this section helpful?

What made this section unhelpful for you?