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 In-person payments > 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.
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":{...},
"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":{...},
"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&...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&...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"
}
}
}