v1

latestOpenAPI 3.0.12026-07-2356172250.9 KB
Mobile Transactions

Start mobile sale transaction

Create a mobile sale transaction using a mobile transaction token that involves authorization and capture. Transactions of $1.00 or greater are approved and automatically added to the open batch for settlement.

post/rest/v2/mobile/transactions/sale

Headers

An access API key issued to you by Xplor Pay.

The transaction token returned from the successfulTransactionToken method of the Mobile framework.

Request body

type'AUTH,SALE,FORCED SALE,REFUND (unmatched only)' required

Type of transaction.

cardstring

Credit card number.

amountstring required

Total transaction amount.

idstring

Unique identifier for the transaction request.

cscstring

Card Security Code (CVV).

invoicestring

Invoice number for the transaction.

descriptionstring

Description of the transaction

commentsstring

Additional comments related to the transaction.

software-typestring required

Type of software initiating the transaction.

software-type-versionstring required

Version of the software used.

sales-tax-type'LOCAL_SALES_TAX,TAX_EXEMPT'

Type of sales tax.

sales-tax-amountstring

Amount of sales tax applied.

service-feestring

Additional service fee.

signature-base-64-imagestring

Base64-encoded signature image.

tip-amountstring

Tip amount included in the transaction.

authorization-codestring

Code used to authorize the transaction.

purchase-orderstring

Purchase order number.

email-receiptstring

Indicates if a receipt should be emailed.

email-addressstring

Email address of the customer.

customer-idstring

Identifier for the customer.

order-idstring

Unique identifier for the order.

client-ipstring

IP address of the client initiating the transaction.

billing-is-shippingstring

Indicates if billing and shipping addresses are the same.

create-tokenstring

Indicates if a token should be created for future use.

token-descriptionstring

Description for the token if created.

check-fieldstring

Field to be checked for validation.

check-field-midboolean

Validates MID (Merchant ID) field.

card-inquiryboolean

If true, performs a card inquiry.

secure3dstring

3D Secure authentication data.

secure3d-ecistring

Electronic Commerce Indicator for 3D Secure.

add-tax-to-amountboolean

Indicates whether sales tax should be added to the total amount used for authorization and capture

Response

Successful Transaction

amountstring

Total value associated with the transaction.

currencystring

Currency used for the transaction.

idstring

Unique transaction ID.

invoicestring

Invoice number associated with the transaction.

descriptionstring

Description of the transaction.

commentsstring

Comments associated with the transaction.

serverIdstring
createdstring

Date and time when the transaction was created.

type'AUTH' | 'SALE' | 'REFUND' | 'VOID' | 'CAPTURE' | 'FORCED SALE' | 'CARD INQUIRY'

Identifies the transaction type.

result'APPROVED' | 'DECLINED' | 'ERROR'

Result of the transaction. For example, APPROVED.

cardstring

Card number used for the transaction.

cscstring

Card Security Code used.

cvm'NON (None)' | 'MSG(Manual Signature)' | 'OFC(Offline Pin in the Clear)' | 'PIN(Online Pin)' | 'OFE(Offline Encrypted Pin)'

Cardholder Verification Method used.

authorization-codestring

Code indicating the transaction authorization.

avs-result-code'X' | 'Y' | 'A' | 'W' | 'Z' | 'N' | 'U' | 'R' | 'S' | 'G'

Result code from Address Verification Service.

avs-result-code-descriptionstring

Description of the AVS result.

csc-result-code'M' | 'N' | 'P' | 'S' | 'U' | 'X'

Result code from CSC verification.

csc-result-code-descriptionstring

Description of the CSC result.

tip-adjusted-amountstring

Amount of the adjusted tip.

avs-streetstring

Street used in AVS check.

avs-zipstring

ZIP code used in AVS check.

token-descriptionstring

Description of the token created.

original-amountstring

Original amount before adjustments.

tip-amountstring

Tip amount included in the transaction.

ref-idstring

Reference ID for the transaction.

entry-methodstring

Method used to enter payment data of the transaction. For example, Swipe/Manual.

first-recurring-transactionstring

Indicates whether this is the first recurring transaction.

batch-string-idstring

Identifies the settlement batch ID.

order-idstring

Order id passed in with the transaction.

purchase-orderstring

Purchase order number.

customer-idstring

Customer id passed in with the transaction.

email-addressstring

Email address associated with the transaction.

display-messagestring

Displayable message about transaction result.

result-codestring

Result code associated with transaction result.

billing-is-shippingstring

Indicates if billing and shipping addresses are the same.

tip-adjustedstring

Indicates if the tip was adjusted.

exp-datestring

Expiration date of the card.

client-ipstring

IP address of the client initiating the transaction.

voidedstring

Indicates if the transaction was voided.

pendingstring

Indicates if the transaction is pending.

voided-authstring

Indicates if the authorization was voided.

settledstring

Indicates if the transaction has been settled.

statusstring

Status of the transaction. For example, approved.

emv-datastring

Raw EMV data string.

key-serial-numberstring

Serial number of the encryption key used.

emv-entry-method'EMV_DIP' | 'EMV_CONTACTLESS' | 'EMV_FALLBACK_SWIPE' | 'EMV_FALLBACK_NONTECH'

Method used to enter EMV data.

software-typestring

Type of software used for the transaction.

customer-first-namestring

First name of the customer.

customer-last-namestring

Last name of the customer.

plan-namestring

Name of the payment plan used.

card-typestring

Type of card used. For example, VISA.

contactlessstring

Indicates if contactless payment was used.

contactless-devicestring

Indicates if a contactless device was used.

sales-tax-typestring

Type of sales tax applied.

sales-tax-amountstring

Amount of sales tax applied.

add-tax-to-amountboolean

Indicates if tax was added to the transaction amount.

emv-data-responsestring

Response data from EMV processing.

signature-base-64-imagestring

Base64-encoded image of the signature.

last-fourstring

Last four digits of the card number.

check-field-duplicateboolean

Indicates if a duplicate check was performed.

service-feestring

Service fee applied to the transaction

base-amountstring

Base amount before taxes and fees.

merchant-idstring

Identifier for the merchant.

terminal-idstring

Identifier for the terminal used.

surcharge-appliedboolean

Indicates if a surcharge was applied.

partial-authorizationboolean

Indicates if partial authorization was allowed.

partial-approvedboolean

Indicates if the transaction was partially approved.

secure3d-ecistring

Electronic Commerce Indicator for 3D Secure.

secure3d-result-codestring

Result code from 3D Secure authentication.

total-amountstring

Total amount including all charges.

processing-party-referencestring

Reference ID from the processing party.

original-processing-party-referencestring

Reference of the original transaction assigned by the processing party.

external-transaction-referencestring

External reference ID for the transaction.

funding-referencestring

Reference for the funding transaction.

token-idstring

Identifier of the payment token.

network-transaction-referencestring

Reference ID from the payment network for the transaction.

create-tokenboolean

Indicates if a token should be created for the transaction.

motoboolean

Indicates whether the transaction is MOTO.

issuer_idstring

Identifier for the card issuer.

digital-wallet-typestring

Type of digital wallet used. For example, GOOGLE.