Pesquisar

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Ordem por correio e telefone (MOTO)

Contornos que passam na opção de oferta MOTO com um PaymentRequest para acionar um pedido por correio e telefone.

Tender options podem ser usadas para modificar sua solicitação de pagamento. As opções de Tender options são passadas para a API de Terminais usando o campo SaleToAcquirerData ou TransactionConditions.

Endpoint

O URL usado para enviar mensagens da API do terminal depende do seu tipo de implementação. Para obter mais informações sobre as arquiteturas disponíveis, consulte Visão geral da API de terminais.

 Solicitação

Tender options são passadas com uma PaymentRequest regular, da mesma maneira que o pagamento básico. Um PaymentRequest pode incluir pares de valores-chave codificados em formulário adicionais no campo SaleToAcquirerData. Isso pode incluir dados para criar contratos recorrentes.

Passe a MOTO tender option em SaleToAcquirerData

As transações MOTO são transações sem cartão, em que os detalhes do pagamento são apresentados a um comerciante por um cliente por meio de correio (não e-mail), fax, ou telefone. The card number and CVC code are entered on the terminal. O número do cartão e o código CVC são inseridos no terminal. O valor máximo que o terminal permitirá uma transação MOTO é configurável na Área do Cliente: vá para Point of sale > Global properties ou selecione um terminal específico e, na guia Currencies & amounts, insira o valor no campo MOTO max amount.

Para iniciar uma transação MOTO, especifique o par tenderOption=MOTO como um valor-chave SaleToAcquirerData ao fazer uma chamada PaymentRequest para a Terminal API.

{
  "SaleToPOIRequest": {
    "PaymentRequest": {
      "SaleData": {
        "SaleTransactionID": {
          "TransactionID": "5748",
          "TimeStamp": "2020-04-15T15:45:04.114Z"
        },
        "SaleToAcquirerData": "tenderOption=MOTO"
      },
      "PaymentTransaction": {
        "AmountsReq": {
          "Currency": "USD",
          "RequestedAmount": 17.50
        }
      }
    },
    "MessageHeader": {
      "ProtocolVersion": "3.0",
      "MessageClass": "Service",
      "MessageCategory": "Payment",
      "MessageType": "Request",
      "ServiceID": "0110123015",
      "SaleID": "POSSystemID12345",
      "POIID": "M400-260193322"
    }
  }
}
String serviceID = "YOUR_UNIQUE_ATTEMPT_ID";
String saleID = "YOUR_CASH_REGISTER_ID";
String POIID = "YOUR_TERMINAL_ID";
String transactionID = "YOUR_UNIQUE_TRANSACTION_ID";

SaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();
MessageHeader messageHeader = new MessageHeader();
messageHeader.setProtocolVersion("3.0");
messageHeader.setMessageClass( MessageClassType.SERVICE );
messageHeader.setMessageCategory( MessageCategoryType.PAYMENT );
messageHeader.setMessageType( MessageType.REQUEST );
messageHeader.setServiceID(serviceID);
messageHeader.setSaleID(saleID);
messageHeader.setPOIID(POIID);
saleToPOIRequest.setMessageHeader(messageHeader);

PaymentRequest paymentRequest = new PaymentRequest();
SaleData saleData = new SaleData();
TransactionIdentification saleTransactionID = new TransactionIdentification();
saleTransactionID.setTransactionID(transactionID);
saleTransactionID.setTimeStamp(DatatypeFactory.newInstance().newXMLGregorianCalendar(new GregorianCalendar()));
saleData.setSaleTransactionID(saleTransactionID);
saleData.setSaleToAcquirerData("tenderOption=MOTO");
paymentRequest.setSaleData(saleData);

PaymentTransaction paymentTransaction = new PaymentTransaction();
AmountsReq amountsReq = new AmountsReq();
amountsReq.setCurrency("EUR");
amountsReq.setRequestedAmount( BigDecimal.valueOf(17.50) );
paymentTransaction.setAmountsReq(amountsReq);
paymentRequest.setPaymentTransaction(paymentTransaction);
saleToPOIRequest.setPaymentRequest(paymentRequest);
terminalAPIRequest.setSaleToPOIRequest(saleToPOIRequest);

Resposta

Para obter uma lista dos campos de resposta de pagamento, consulte campos PaymentResponse.

É tentada uma autorização e você recebe uma resposta com os seguintes campos:

{
   "SaleToPOIResponse":{
      "PaymentResponse":{
         "POIData":{
            "POITransactionID":{
               "TimeStamp":"2019-05-09T12:42:43.000Z",
               "TransactionID":"4rVu001557405763003.8815574057779467"
            },
            "POIReconciliationID":"1000"
         },
         "SaleData":{
            "SaleTransactionID":{
               "TimeStamp":"2019-05-09T11:30:15.000Z",
               "TransactionID":"5748"
            }
         },
         "PaymentReceipt":[
            {
               "RequiredSignatureFlag":false,
               "DocumentQualifier":"CashierReceipt",
               "OutputContent":{
                  "OutputFormat":"Text",
                  "OutputText":[
                     {
                        "CharacterStyle":"Bold",
                        "Text":"key=header1",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"key=header2",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"name=MERCHANT%20COPY&key=merchantTitle",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Date&value=09%2f05%2f19&key=txdate",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Time&value=14%3a42%3a43&key=txtime",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Card&value=%2a%2a%2a%2a%2a%2a%2a%2a%2a%2a%2a%2a1111&key=pan",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Card%20type&value=mc&key=cardType",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Payment%20method&value=mc&key=paymentMethod",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Payment%20variant&value=mc&key=paymentMethodVariant",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Entry%20mode&value=MKE&key=posEntryMode",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=MID&value=1000&key=mid",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=TID&value=P400Plus-275040702&key=tid",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=PTID&value=75040702&key=ptid",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Auth.%20code&value=40600&key=authCode",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Tender&value=4rVu001557405763003&key=txRef",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Reference&value=5748&key=mref",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Type&value=GOODS_SERVICES&key=txtype",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"name=TOTAL&value=%e2%82%ac%c2%a010.99&key=totalAmount",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"name=APPROVED&key=approved",
                        "EndOfLineFlag":true
                     }
                  ]
               }
            },
            {
               "RequiredSignatureFlag":false,
               "DocumentQualifier":"CustomerReceipt",
               "OutputContent":{
                  "OutputFormat":"Text",
                  "OutputText":[
                     {
                        "CharacterStyle":"Bold",
                        "Text":"key=header1",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"key=header2",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"name=CARDHOLDER%20COPY&key=cardholderHeader",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Date&value=09%2f05%2f19&key=txdate",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Time&value=14%3a42%3a43&key=txtime",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Card&value=%2a%2a%2a%2a%2a%2a%2a%2a%2a%2a%2a%2a1111&key=pan",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Card%20type&value=mc&key=cardType",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Payment%20method&value=mc&key=paymentMethod",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Payment%20variant&value=mc&key=paymentMethodVariant",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Entry%20mode&value=MKE&key=posEntryMode",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=MID&value=1000&key=mid",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=TID&value=P400Plus-275040702&key=tid",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=PTID&value=75040702&key=ptid",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Auth.%20code&value=40600&key=authCode",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Tender&value=4rVu001557405763003&key=txRef",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Reference&value=5748&key=mref",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Type&value=GOODS_SERVICES&key=txtype",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"name=TOTAL&value=%e2%82%ac%c2%a010.99&key=totalAmount",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "CharacterStyle":"Bold",
                        "Text":"name=APPROVED&key=approved",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"key=filler",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Please%20retain%20for%20your%20records&key=retain",
                        "EndOfLineFlag":true
                     },
                     {
                        "Text":"name=Thank%20you&key=thanks",
                        "EndOfLineFlag":true
                     }
                  ]
               }
            }
         ],
         "PaymentResult":{
            "OnlineFlag":true,
            "PaymentAcquirerData":{
               "AcquirerPOIID":"P400Plus-275040702",
               "ApprovalCode":"40600",
               "AcquirerTransactionID":{
                  "TimeStamp":"2019-05-09T12:42:43.000Z",
                  "TransactionID":"8815574057779467"
               },
               "MerchantID":"SamPOS"
            },
            "PaymentInstrumentData":{
               "CardData":{
                  "EntryMode":[
                     "Keyed"
                  ],
                  "PaymentBrand":"mc",
                  "MaskedPan":"555544 **** 1111",
                  "SensitiveCardData":{
                     "ExpiryDate":"1020"
                  }
               },
               "PaymentInstrumentType":"Card"
            },
            "AmountsResp":{
               "AuthorizedAmount":10.99,
               "Currency":"EUR"
            }
         },
         "Response":{
            "Result":"Success",
            "AdditionalResponse":"tid=75040702&transactionType=GOODS_SERVICES&backendGiftcardIndicator=false&expiryYear=2020&acquirerAccountCode=TestPmmAcquirerAccount&alias=F108461732583205&posOriginalAmountCurrency=EUR&giftcardIndicator=false&authorisedAmountValue=1099&retry.attempt1.shopperInteraction=Moto&pspReference=8815574057771234&paymentMethodVariant=mc&refusalReasonRaw=AUTHORISED&authorisationMid=1000&acquirerCode=TestPmmAcquirer&store=StoreOne&txtime=14%3a42%3a43&iso8601TxDate=2019-05-09T12%3a42%3a43.0000000%2b0000&cardType=mc&posOriginalAmountValue=1099&offline=false&aliasType=Default&txdate=09-05-2019&paymentMethod=mc&cvcResult=3%20Not%20checked&avsResult=4%20AVS%20not%20supported%20for%20this%20card%20type&mid=1000&merchantReference=5748&transactionReferenceNumber=8815574057779467&expiryMonth=10&cardSummary=1111&posTotalAmountValue=1099&posAuthAmountCurrency=EUR&cvcResultRaw=P&authCode=40600&avsResultRaw=4&posEntryMode=MKE&acquirerReference=7CAV1QT2DFP&cardScheme=mc&cardBin=555544&posAuthAmountValue=1099"
         }
      },
      "MessageHeader":{
         "SaleID":"SamPOS",
         "MessageClass":"Service",
         "MessageCategory":"Payment",
         "ServiceID":"MKEtest",
         "POIID":"P400Plus-275040702",
         "MessageType":"Response"
      }
   }
}