Credit Card-Mail Order and Telephone Order
Credit Card-Mail Order and Telephone Order
Mail Order and Telephone Order which is also known as CCARD-MOTO, standing for credit card payments based on a Mail Order or Telephone Order, is intended for back-office transactions and is suited for any system that’s capable of storing orders, such as ERP systems and call center applications.
When using this payment method, consumers have two options to order services or items:
-
Per mail, fax or letter: The consumer forwards the order and the payment method details to the merchant in written form.
-
Per telephone: Consumer calls e.g. the service center to place the order and communicates the payment method details by telephone.
| When the service center staff has access to an ERP system, they may verify whether the products which are ordered via phone or fax are available while at the same time checking the validity of the consumer’s credit card data. |
The merchant configuration has to be changed by our integration specialists on your behalf, and acquirers might require to meet additional and special conditions to fulfill PCI security standards in their acceptance contracts.
Consumers must never disclose their 3-D Secure code to the service center staff when placing mail or telephone orders.
Commands
Pre Transaction Commands
The first step is to generate a unique order number with the command CREATEORDER.
Transaction Commands
INITIATEPAYMENT
The initiation happens here without a check of the cards for 3-D Secure. Necessary for mail order/tele-order, call center.
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Optional request parameters CUSTOMERSTATEMENT and ORDERREFERENCE, are more restricted about their length and allowed characters than usual.
MOTO payment method can be initialized if the merchant sends CCARD for parameter INITTYPE and CREDITCARD for parameter PAYMENTTYPE.
|
Responses
201 Successful initialization.
Required Parameters
Optional Parameters
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=INITIATEPAYMENT&
PAYMENTTYPE=CREDITCARD&
INITTYPE=CCARD&
DEPOSITAMOUNT=0&
ORDERNUMBER=15457193&
LANGUAGE=en&
TRANSACTION_IDENTIFIER=MOTO&
AMOUNT=1.00&
CURRENCY=EUR&
PAN=4000012892688323&
EXPIRY=12/2023&
QTILL_CLIENT_IP_ADDRESS=172.20.10.12&
CUSTOMERSTATEMENT=custmomer123&
ORDERDESCRIPTION=Test:0000&
APPLICATIONTYPE=S&Response samples
version=qtillserver+3.23.0.47&
status=0Because this is a synchronous payment method, the result is provided immediately.
VERIFYPAYMENT
| For mail orders and telephone orders, VERIFYPAYMENT isn’t mandatory. |
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Responses
201 Successful verification.
Required Parameters
Optional Parameters
Order as a basis type of properties in the response can be returned for this command.
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=VERIFYPAYMENT&
APPLICATIONTYPE=S&
ORDERNUMBER=15457193&
LANGUAGE=enResponse samples
order.1.amount=1.00&
payment.1.1.paymentNumber=15457193&
payment.1.1.depositAmount=1.00&
order.1.orderText=Test%3A0000&
order.1.contractNumber=Qenta_Test2&
payment.1.1.timeModified=26.10.2022+12%3A54%3A27&
payment.1.1.operationsAllowed=DEPOSITREVERSAL&
payment.1.1.paymentType=CREDITCARD&
order.1.merchantNumber=840&
payment.1.1.state=payment_deposited&
order.1.depositAmount=1.00&
order.1.customerStatement=custmomer123&
order.1.providerContractNumber=Qenta_Test2&
order.1.timeModified=26.10.2022+12%3A54%3A27&
payment.1.1.approvalCode=786404&
payment.1.1.providerReferenceNumber=916d21de8b9c4859812747c90eaa535e&
order.1.orderNumber=15457193&
payment.1.1.gatewayReferenceNumber=d88f476cc21747a9b566fc56539ec9bb&
payment.1.1.orderNumber=15457193&
payment.1.1.approveAmount=1.00&
order.1.approveAmount=0&
order.1.credits=0&
payment.1.1.merchantNumber=840&
order.1.payments=1&
order.1.currency=EUR&
version=qtillserver+3.23.0.48&
order.1.refundAmount=0&
payment.1.1.currency=EUR&
order.1.timeCreated=26.10.2022+12%3A54%3A27&
order.1.state=ORDERED&
order.1.orderDescription=Test%3A0000&
orders=1&
payment.1.1.timeCreated=26.10.2022+12%3A54%3A27&
payment.1.1.batchNumber=300000576&
order.1.acquirer=QENTA&
order.1.paymentType=CREDITCARD&
order.1.brand=VISA&
status=0Post Transaction Commands
GETORDERDETAILS
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Responses
201 Successful getting order details.
Required Parameters
Optional Parameters
Order as a basis type of properties in the response can be returned for this command.
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=GETORDERDETAILS&
ADMIN_PASSWORD=9p3a0m5f&
ORDERNUMBER=15457193&
APPLICATIONTYPE=S&Response samples
order.1.amount=1.00&
payment.1.1.paymentNumber=15457193&
payment.1.1.timeModified=26.10.2022+12%3A54%3A27&
payment.1.1.operationsAllowed=DEPOSITREVERSAL&
payment.1.1.paymentType=CREDITCARD&
order.1.merchantNumber=840&
order.1.depositAmount=1.00&
payment.1.1.approvalCode=786404&
payment.1.1.providerReferenceNumber=916d21de8b9c4859812747c90eaa535e&
payment.1.1.orderNumber=15457193&
rder.1.approveAmount=0&
order.1.credits=0&
payment.1.1.merchantNumber=840&
order.1.payments=1&
version=qtillserver+3.23.0.48&
order.1.state=ORDERED&
payment.1.1.currency=EUR&
order.1.refundAmount=0&
orders=1&
order.1.brand=VISA&
order.1.acquirer=QENTA&
payment.1.1.batchNumber=300000576&
status=0&
payment.1.1.depositAmount=1.00&
order.1.orderText=Test%3A0000&
order.1.contractNumber=Qenta_Test2&
payment.1.1.state=payment_deposited&
order.1.customerStatement=custmomer123&
order.1.providerContractNumber=Qenta_Test2&
order.1.orderNumber=15457193&
order.1.timeModified=26.10.2022+12%3A54%3A27&
payment.1.1.gatewayReferenceNumber=d88f476cc21747a9b566fc56539ec9bb&objectsTotal=1&
payment.1.1.approveAmount=1.00&
order.1.currency=EUR&
order.1.timeCreated=26.10.2022+12%3A54%3A27&
order.1.orderDescription=Test%3A0000&
payment.1.1.timeCreated=26.10.2022+12%3A54%3A27&
order.1.paymentType=CREDITCARDDEPOSIT
The transaction can be deposited:
-
By using the command DEPOSIT.
| This is only possible if the transaction is not deposited in any other way. |
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Responses
201 Successful deposit.
Required Parameters
Optional Parameters
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=DEPOSIT&
ORDERNUMBER=15921723&
PAYMENTNUMBER=15921723&
AMOUNT=1.00&
CURRENCY=EUR&
LANGUAGE=en&
APPLICATIONTYPE=SResponse samples
version=qtillserver+3.23.0.48&
paymentNumber=15921723&
status=0DEPOSITREVERSAL
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Responses
201 Successful reversal deposit.
Required Parameters
Optional Parameters
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=DEPOSITREVERSAL&
ORDERNUMBER=10970158&
PAYMENTNUMBER=10970158&
CURRENCY=EUR&
ADMIN_PASSWORD=9p3a0m5f&
LANGUAGE=en&
APPLICATIONTYPE=SResponse samples
version=qtillserver+3.23.0.48&
status=0APPROVEREVERSAL
| For using the command APPROVEREVERSAL, payment needs to be in an approved state. Look at the order flow diagram of the payment method for closer information. |
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Responses
201 Successful approving reversal.
Required Parameters
Optional Parameters
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=APPROVEREVERSAL&
ORDERNUMBER=15422959&
PAYMENTNUMBER=15422959&
ADMIN_PASSWORD=9p3a0m5f&
LANGUAGE=en&
APPLICATIONTYPE=S&Response samples
version=qtillserver+3.23.0.47&
status=0RECURPAYMENT
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Responses
201 Successful approving reversal.
Required Parameters
Optional Parameters
POST / https://api.qenta.com/enterprise
Request samples
COMMAND=RECURPAYMENT&
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
ORDERNUMBER=12868716&
SOURCEORDERNUMBER=15921723&
AMOUNT=1&
CURRENCY=EUR&
ORDERDESCRIPTION=Test:0000&
ADMIN_PASSWORD=9p3a0m5f&
APPLICATIONTYPE=S&Response samples
version=qtillserver+3.23.0.48&
status=0REFUND
Basic Auth
Request
| Required Parameters | Optional Parameters | ||
|---|---|---|---|
|
Responses
201 Successful refunding.
Required Parameters
Optional Parameters
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=REFUND&
ORDERNUMBER=12722559&
CURRENCY=EUR&
AMOUNT=1.00&
ADMIN_PASSWORD=9p3a0m5f&
APPLICATIONTYPE=S&
LANGUAGE=en&Response samples
creditNumber=10684965&
version=qtillserver+3.23.0.48&
status=0REFUNDREVERSAL
Basic Auth
Request
| Required Parameters | Optional Parameters |
|---|---|
Responses
201 Successful reversal refunding .
Required Parameters
Optional Parameters
POST / https://api.qenta.com/enterprise
Request samples
MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
COMMAND=REFUNDREVERSAL&
ORDERNUMBER=12722559&
CREDITNUMBER=10684965& (1)
ADMIN_PASSWORD=9p3a0m5f&
APPLICATIONTYPE=S&
LANGUAGE=en| 1 | Use a credit number got from the refund. |
Response samples
version=qtillserver+3.23.0.49&
status=0Query Commands
For every payment method commands QUERYORDERS, QUERYCREDITS, and QUERYBATCHES are used.