Serviço de efetivação de pagamento com múltiplos meios de pagamento

Após consumir o serviço de criação de transação e obter um NIT, é possível prosseguir para a próxima etapa do fluxo: a chamada ao serviço de efetivação de pagamento.

Isso pode ser feito informando apenas um meio de pagamento (veja o documento "Serviço de efetivação de pagamento") ou 2 (dois) meios de pagamento.

Neste capítulo, trataremos dos pagamentos que são feitos com 2 (dois) meios de pagamento, o qual chamamos de Pagamento com múltiplos meios de pagamento.

Para usar esta funcionalidade, entre em contato com o nosso suporte e solicite a ativação da mesma em sua loja.

Fluxo#

O fluxo de um pagamento com múltiplos meios de pagamento possui diferenças importantes quando o comparamos com o pagamento tradicional.

A primeira diferença é que temos duas transações para uma mesma chamada e cada uma delas é usada para efetuar o pagamento de um dos meios de pagamento informados. A primeira transação é criada na chamada de criação de transação no Pagamento Online e a segunda transação é criada indiretamente na chamada de pagamento com múltiplos meios de pagamento.

A segunda diferença é que, por causa disso, alguns dados da primeira transação são modificados durante a efetivação do pagamento. Inicialmente, a primeira transação possui o valor total da compra, as parcelas e o tipo de financiamento próprios. Quando a chamada de pagamento com múltiplos pagamentos é feita, seu valor é alterado para ser igual ao do primeiro meio de pagamento e o mesmo ocorre com as parcelas e o tipo de financiamento, caso estes sejam informados na requisição. Já a segunda transação terá o valor, as parcelas e o tipo de financiamento informados pelo segundo meio de pagamento. Mas, no caso da segunda transação não informar dados de parcelamento e tipo de financiamento, ela herdará essas configurações da primeira transação original. A soma dos valores da primeira e da segunda transações deve ser igual ao valor informado na criação da primeira transação no Pagamento Online.

A terceira diferença é que a resposta de múltiplos pagamentos é composta pelas respostas de cada uma das transações. Sendo assim, haverá situações em que a resposta de uma transação afetará a resposta da outra.

A seguir, iremos abordar os cenários previstos no Pagamento Online com mais detalhes.

Fluxo de pagamento com confirmação automática#

O fluxo de pagamento com confirmação automática nos pagamentos com múltiplos meios de pagamentos possui uma peculiaridade que é dividir o pagamento em 3 (três) etapas: atualização/inicialização das transações; pagamentos; confirmações.

Em caso de falha em qualquer uma das transações, o Pagamento Online não prossegue para a etapa seguinte e faz tratamentos que serão explicados a seguir nos casos de falhas.

Caso de sucesso#

Caso de falha no pagamento da primeira transação#

Quando o primeiro pagamento falha, a segunda transação será cancelada e não será disparada para a Autorizadora. Uma ocorrência é gerada para a equipe de suporte do Pagamento Online e o lojista, caso deseje, pode entrar em contato.

Exemplo de resposta#
{
"code": "1013",
"message": "Error processing multiple payment methods",
"payments": [
{
"authorizer_code": "014",
"authorizer_message": "14 Cartao Inval.",
"status": "NEG",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "1609964926966",
"authorizer_id": "1",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "06/01/2021T17:28",
"authorization_number": "080384",
"merchant_usn": "16114726760",
"esitef_usn": "210106064204400",
"sitef_usn": "606060",
"host_usn": "707070",
"amount": "1254785",
"payment_type": "C",
"issuer": "1",
"authorizer_merchant_id": "00000005",
"terminal_id": "ES000036"
},
{
"status": "CAN"
}
]
}

Caso de falha no pagamento da segunda transação#

Quando o segundo pagamento falha, a primeira transação será desfeita. Uma ocorrência é gerada para a equipe de suporte do Pagamento Online e o lojista, caso deseje, pode entrar em contato.

Exemplo de resposta#
{
"code": "1013",
"message": "Error processing multiple payment methods",
"payments": [
{
"authorizer_code": "000",
"authorizer_message": "Transacao Aprov.",
"status": "PPN",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "25053142469",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "1",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "25/03/2020T17:31",
"authorization_number": "252490",
"merchant_usn": "25053142469",
"esitef_usn": "200325048537130",
"sitef_usn": "252490",
"host_usn": "999252490 ",
"amount": "100",
"payment_type": "C",
"issuer": "1",
"authorizer_merchant_id": "000000000000005",
"payment_date": "25/03/2020T17:31"
},
{
"authorizer_code": "255",
"authorizer_message": "(2)Cartao invalido",
"status": "NEG",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "25053142469",
"authorizer_id": "2",
"acquirer_name": "REDE",
"merchant_usn": "25053142469",
"esitef_usn": "200325048537140"
}
]
}

Caso de falha na confirmação da primeira transação#

Quando a primeira confirmação falha, a segunda transação será desfeita. Uma ocorrência é gerada para a equipe de suporte do Pagamento Online e o lojista, caso deseje, pode entrar em contato.

Exemplo de resposta#
{
"code": "1013",
"message": "Error processing multiple payment methods",
"payments": [
{
"authorizer_code": "200",
"authorizer_message": "Success. [Cód.: 00]",
"status": "PEN",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "1609965604696",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "2",
"acquirer_id": "202",
"acquirer_name": "e.Rede REST",
"authorizer_date": "06/01/2021T17:40",
"authorization_number": "177013",
"merchant_usn": "16114726760",
"esitef_usn": "210106064204470",
"host_usn": "304123216",
"tid": "210106064204470",
"amount": "47",
"payment_type": "C",
"payment_date": "06/01/2021T17:40"
},
{
"authorizer_code": "200",
"authorizer_message": "Success. [Cód.: 00]",
"status": "PPN",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "1609965604696",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "2",
"acquirer_id": "202",
"acquirer_name": "e.Rede REST",
"authorizer_date": "06/01/2021T17:40",
"authorization_number": "962291",
"merchant_usn": "16114726760",
"esitef_usn": "210106064204480",
"host_usn": "487097429",
"tid": "210106064204480",
"amount": "510",
"payment_type": "C",
"payment_date": "06/01/2021T17:40"
}
]
}

Caso de falha na confirmação da segunda transação#

Quando a segunda confirmação falha, a primeira transação já está confirmada e o cancelamento, caso seja desejado, deve ser feito manualmente, seja usando o cancelamento REST ou o Portal do Lojista. Uma ocorrência é gerada para a equipe de suporte do Pagamento Online e o lojista, caso deseje, pode entrar em contato.

Exemplo de resposta#
{
"code": "1013",
"message": "Error processing multiple payment methods",
"payments": [
{
"authorizer_code": "200",
"authorizer_message": "Function performed error-free [Cód.: 00]",
"status": "CON",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "20030404545",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "2",
"acquirer_id": "414",
"acquirer_name": "IPG",
"authorizer_date": "25/03/2020T17:48",
"authorization_number": "488040",
"merchant_usn": "20030404545",
"esitef_usn": "200325048537190",
"host_usn": "572994560",
"tid": "SIM64194442",
"amount": "102",
"payment_type": "C",
"payment_date": "25/03/2020T17:48"
},
{
"authorizer_code": "200",
"authorizer_message": "Function performed error-free [Cód.: 00]",
"status": "PEN",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "20030404545",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "2",
"acquirer_id": "414",
"acquirer_name": "IPG",
"authorizer_date": "25/03/2020T17:48",
"authorization_number": "454463",
"merchant_usn": "20030404545",
"esitef_usn": "200325048537200",
"host_usn": "108829897",
"tid": "SIM45823552",
"amount": "103",
"payment_type": "C",
"payment_date": "25/03/2020T17:48"
}
]
}

Fluxo de pagamento com confirmação tardia#

O fluxo de pagamento com confirmação tardia nos pagamentos com múltiplos meios de pagamentos possui uma peculiaridade que é dividir o pagamento em 2 (duas) fases: atualização/inicialização das transações; pagamentos.

Em caso de falha em qualquer uma das transações, o Pagamento Online não prossegue para a etapa seguinte e faz tratamentos que serão explicados a seguir nos casos de falhas.

Caso de sucesso#

Caso de falha no pagamento da primeira transação#

Quando o primeiro pagamento falha, a segunda transação será cancelada e não será disparada para a Autorizadora.

Exemplo de resposta#
{
"code": "1013",
"message": "Error processing multiple payment methods",
"payments": [
{
"authorizer_code": "19",
"authorizer_message": "19 Refaca Trans.",
"status": "NEG",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "25052428543",
"authorizer_id": "1",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "25/03/2020T17:24",
"authorization_number": "080384",
"merchant_usn": "25052428543",
"esitef_usn": "200325048537090",
"sitef_usn": "606060",
"host_usn": "707070",
"amount": "1254784",
"payment_type": "C",
"issuer": "1",
"authorizer_merchant_id": "00000005"
},
{
"status": "CAN"
}
]
}

Caso de falha no pagamento da segunda transação#

Quando o segundo pagamento falha, a primeira transação será desfeita.

Exemplo de resposta#
{
"code": "1013",
"message": "Error processing multiple payment methods",
"payments": [
{
"authorizer_code": "000",
"authorizer_message": "Transacao Aprov.",
"status": "PPN",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "25053142469",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "1",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "25/03/2020T17:31",
"authorization_number": "252490",
"merchant_usn": "25053142469",
"esitef_usn": "200325048537130",
"sitef_usn": "252490",
"host_usn": "999252490 ",
"amount": "100",
"payment_type": "C",
"issuer": "1",
"authorizer_merchant_id": "000000000000005",
"payment_date": "25/03/2020T17:31"
},
{
"authorizer_code": "255",
"authorizer_message": "(2)Cartao invalido",
"status": "NEG",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "25053142469",
"authorizer_id": "2",
"acquirer_name": "REDE",
"merchant_usn": "25053142469",
"esitef_usn": "200325048537140"
}
]
}

Detalhes da chamada#

  • Recurso: /v1/payments/multiple/{nit}
  • Método HTTP: POST
  • Formato da requisição: JSON
  • Formato da resposta: JSON
  • Parâmetros de cabeçalho:
ParâmetroDescriçãoFormatoObrigatório
merchant_idCódigo da loja no Pagamento Online. Os códigos de produção e certificação serão diferentes.< 15 ANSIM
merchant_keyChave de autenticação da loja no Pagamento Online. As chaves de produção e certificação serão diferentes.< 80 ANSIM
Content-TypeDeve ser enviado com o valor application/json.= 15 ANSIM

Exemplos#

Abaixo estão alguns exemplos de chamada do serviço de efetivação de pagamento utilizando a ferramenta cURL.

Pagamento#

Requisição:

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/payments/multiple/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
"multiple_payment_methods": [
{
"number": "45518201234512345",
"expiry_date": "1222",
"security_code": "123",
"authorizer_id": "218",
"installments": "1",
"installment_type": "4",
"amount": "512"
},
{
"number": "45518201234512345",
"expiry_date": "1222",
"security_code": "123",
"authorizer_id": "218",
"installments": "1",
"installment_type": "4",
"amount": "510"
}
]
}
--verbose

Resposta:

{
"code": "0",
"message": "OK. Transaction successful.",
"payments": [
{
"authorizer_code": "000",
"authorizer_message": "Transacao Aprov.",
"status": "PPC",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "20125445982",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "1",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "20/03/2020T14:32",
"authorization_number": "202650",
"merchant_usn": "16013439434",
"esitef_usn": "200320048363850",
"sitef_usn": "202650",
"host_usn": "999202650 ",
"amount": "512",
"payment_type": "C",
"issuer": "1",
"authorizer_merchant_id": "000000000000005",
"payment_date": "20/03/2020T14:32"
},
{
"authorizer_code": "000",
"authorizer_message": "Transacao Aprov.",
"status": "PPC",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "20125445982",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "2",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "20/03/2020T14:32",
"authorization_number": "202651",
"merchant_usn": "16013439434",
"esitef_usn": "200320048363860",
"sitef_usn": "202651",
"host_usn": "999202651 ",
"amount": "510",
"payment_type": "C",
"issuer": "2",
"authorizer_merchant_id": "000000000000005",
"payment_date": "20/03/2020T14:32"
}
]
}

Pagamento com cartão armazenado#

Requisição:

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/payments/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
"multiple_payment_methods": [
{
"token": "g16hJtpdU6XEN3FP-ApQ9pKTGII5Fa9Y12tRX-qfyC-+BUCV5OaFn807zwwOR6rDtKoRnIJg0QbikaJqJqosyQ==",
"authorizer_id": "1",
"installments": "1",
"installment_type": "4",
"amount": "512",
"security_code": "123"
},
{
"token": "g16hJtpdU6XEN3FP-ApQ9pKTGII5Fa9Y12tRX-qfyC-+BUCV5OaFn807zwwOR6rDtKoRnIJg0QbikaJqJqosyQ==",
"authorizer_id": "2",
"installments": "1",
"installment_type": "3",
"amount": "510",
"security_code": "321"
}
]
}
--verbose

Resposta:

{
"code": "0",
"message": "OK. Transaction successful.",
"payments": [
{
"authorizer_code": "000",
"authorizer_message": "Transacao Aprov.",
"status": "PPC",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "20125445982",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "1",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "20/03/2020T14:32",
"authorization_number": "202650",
"merchant_usn": "16013439434",
"esitef_usn": "200320048363850",
"sitef_usn": "202650",
"host_usn": "999202650 ",
"amount": "512",
"payment_type": "C",
"issuer": "1",
"authorizer_merchant_id": "000000000000005",
"payment_date": "20/03/2020T14:32"
},
{
"authorizer_code": "000",
"authorizer_message": "Transacao Aprov.",
"status": "PPC",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"order_id": "20125445982",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "2",
"acquirer_id": "5",
"acquirer_name": "Redecard",
"authorizer_date": "20/03/2020T14:32",
"authorization_number": "202651",
"merchant_usn": "16013439434",
"esitef_usn": "200320048363860",
"sitef_usn": "202651",
"host_usn": "999202651 ",
"amount": "510",
"payment_type": "C",
"issuer": "2",
"authorizer_merchant_id": "000000000000005",
"payment_date": "20/03/2020T14:32"
}
]
}

Código de Retorno

CódigoDescrição
0Transação OK
1Campo NIT nulo
2Request enviado é nulo
3Campo NIT inválido
4Campo authorizerId nulo
5Campo authorizerId inválido
6Campo autoConfirmation nulo
7Campo autoConfirmation vazio
8Campo cardExpireDate nulo
9Campo cardExpireDate inválido
10Campo cardNumber nulo
11Campo cardNumber inválido
12Campo cardSecurityCode nulo
13Campo cardSecurityCode inválido
14Campo installments nulo
15Campo installments inválido
16Campo installmentType nulo
17Campo installmentType inválido
18Campo customerId nulo
19Campo customerId inválido
20Campo departureTax nulo
21Campo departureTax inválido
22Campo firstInstallment nulo
23Campo firstInstallment inválido
24Campo softDescriptor nulo
25Campo softDescriptor inválido
26Campo merchantKey nulo
27Campo merchantKey inválido
28Campo nsuSitef nulo
29Campo nsuSitef inválido
30Campo merchantId nulo
31Campo merchantId inválido
32Campo amount nulo
33Campo amount inválido
34Campo esitefUSN nulo
35Campo esitefUSN invalid
36Campo merchantUSN nulo
37Campo merchantUSN inválido
38Campo ordered inválido
39Campo parameter inválido
40Campo parameter nulo
41Campo parameterNumber inválido
42Campo jsonXml nulo
43Campo jsonXml inválido
44Método nulo
45Método inválido
46Campo url inválido
47Campo redirect inválido
48Campo card_hash nulo
49Campo card_hash inválido
50Campo financing_type nulo
51Campo financing_type inválido
52Campo sitef_ip inválido
53Campo sitef_port inválido
54Campo sitef_terminal inválido
55Campo sitef_merchant_id inválido
56Campo confirmation_data inválido
57Campo confirmation_type inválido
58Campo inner_transactions vazio ou nulo
59Campo extra_field inválido
60Campo prefixes / key vazio
61Campo prefixes / value vazio
62Campo additional_data inválido
63Campo prefixes inválido
64Campo financing_type com juros não permitido
68Campo dealer_code nulo
69Campo dealer_code inválido
70Campo phone_ddd nulo
71Campo phone_number nulo
72Campo amount_key inválido
73Campos card_number e card_token não podem ser utilizados simultaneamente
74Campo amount não pode ser pré-fixado para recarga
75Campo phone_ddd inválido
76Campo phone_number inválido
77Campo store_card inválido
78Campo store_identification nulo
79Campo recharge_included inválido
80Autorizadora não implementada para mobile
81Operação não permitida
82Transação não encontrada
83Campo store_identification inválido
84Armazenamento não permitido para a autozadora escolhida
85Campo purchase_summary invalido
86Lista de itens vazia
87Campo authenticate inválido
88Cartão inválido. Verifique o número do cartão ou a forma de pagamento escolhida.
89Erro ao recuperar a transação
100Falha ao efetuar transação de pagamento
101Falha ao confirmar transação de pagamento
102Transação já finalizada ou em andamento
103Tipo de transação inválido
104Autorizadora para a transação inválida
105Estilo da transação inválido
106Loja sem permissão para a operação
107Operação não permitida para o status da transação
108Autorizadora inativa ou não habilitada para a loja.
109Parcelas excedem o limite configurado na autorizadora
110Loja inativa
111Tipo de Autorizadora Inválida
112Autorizadora com configuração inválida
113Autorizadora não habilitada ou inativa para a Loja.
114Transação Bloqueada.
115Erro de autenticidade
116Erro na consulta de transação. Por favor tente novamente mais tarde.
131Falha de comunicação com o SiTef
132Request mal formatado
134Erro na consulta de cartão (card query)
135Loja não possui permissão para pagamento Split.
136Falha no rollback
137Operação inválida.
138Falha na escolha de autorizadora
139Não existe autorizadora configurada
140Consulta devolveu muitas autorizadoras, não foi possível identificar unicamente
141A autorizadora passada não é roteada via SiTef
142Erro ao consultar cartão resposta inesperada da autorizadora
143O número de cartão enviado não corresponde à forma de pagamento escolhida.
144Loja sem permissão para Recarga V5 HTML
145Loja sem permissão para Recarga V5 WebService
146Erro na autenticação
147Autenticação Negada
148Autenticação não permitida para esta autorizadora
149Loja sem dados cadastrais de autenticação ISA
150Request inválido
157Campo showTimesInvoice inválido
160Loja sem permissão para transações HTML
161Loja sem permissão para transações de pagamento
162Loja sem permissão para transações IATA
163Cadastro da Autorizadora com erros.
215Venda com cartão tipo Gift não habilitada
216Recarga de cartão tipo Gift não habilitada
217Cancelamento de pagamento via cartão tipo Gift não habilitada
230campo payer neighborhood inválido
231campo payer uf inválido
232campo payer name inválido
233campo payer address_street_name / address_street_number inválido
234campo payer identification_number inválido
235campo payer city inválido
236campo payer zipcode inválido
255Pagamento negado
256Aguardando resposta do cancelamento
257Estorno negado
258Recarga negada
259Transação negada
260Recarga desfeita por falha no pagamento
261Recarga deve ser reenviada
300Erro ao criar transação de refund
301Campo card_number diferente
302Falha de comunicação
304Campo extra_info inválido
305Campo currency inválido
306Campo insurance_amt inválido
307Campo handling_amt inválido
308Campo tax_amount inválido
309Campo inner_transaction order_id inválido
310Campo inner_transaction merchant_id inválido
311Campo inner_transaction merchant_usn inválido
312Campo inner_transaction amount inválido
313campo shipment type inválido
314Campo shipment cost inválido
315Campo shipment discount_amount inválido
316Campo shipment receiver_address_apartment inválido
317Campo shipment receiver_address_floor inválido
318Campo shipment receiver_address_street_name inválido
319Campo shipment receiver_address_street_number inválido
320Campo shipment receiver_address_zip_code inválido
321Campo shipment receiver_address_complement inválido
322Campo shipment receiver_address_district inválido
323Campo shipment receiver_address_city inválido
324Campo shipment receiver_address_state inválido
325Campo shipment receiver_address_country inválido
326Campo shipment receiver_address_name inválido
327Campo shipment receiver_address_phone_area_code inválido
328Campo shipment receiver_address_phone_number inválido
329Campo payment_method installments inválido
330Campo payment_method excluded_payment_method id inválido
331Campo payment_method excluded_payment_method name inválido
332Campo payment_method excluded_payment_method payment_type_id inválido
333Campo payment_method excluded_payment_method thumbnail inválido
334Campo payment_method excluded_payment_method secure_thumbnail inválido
335Campo payment_method excluded_payment_type id inválido
336Campo payment_method excluded_payment_type name inválido
337Campo payer phone_number inválido
338Campo payer phone_area_code inválido
339Campo payer date_created inválido
340Campo payer email inválido
341Campo payer born_date inválido
342Campo payer mother_name inválido
343Campo payer father_name inválido
344Campo payer sex inválido
345Campo payer phone_country_code inválido
346Campo payer phone_extension inválido
347Campo payer phone_extension_type inválido
348Campo payer tax_type inválido
349Campo payer address_type inválido
350Campo item id inválido
351Campo item description inválido
352Campo item category_id inválido
353Campo item picture_url inválido
354Campo item unit_price inválido
355Campo item quantity inválido
356Campo item title inválido
357Campo item weight inválido
358Campo item shipping_cost inválido
359Campo item quantity_itens_sum inválido
360Campo item tax_amount inválido
361Campo item weight_unit inválido
362Campo item length inválido
363Campo item length_unit inválido
364Campo item width inválido
365Campo item width_unit inválido
366Campo item height inválido
367Campo item height_unit inválido
368Campo item url inválido
369Campo item type inválido
370Campo extra_param metadata_item key inválido
371Campo extra_param metadata_item inválido inválido
372Campo extra_param metadata_item group inválido
373Campo extra_param prefix key inválido
374Campo extra_param prefix value inválido
375Campo extra_param acquirer_param key inválido
376Campo extra_param acquirer_param value inválido
400Transação abortada
723Condições enviadas para a adquirentes não suportadas. / Credenciais da adquirente inválidas.
724Campo max_installments inválido
910Transação negada pela e-Rede.
920Transação negada pela Cielo e-Commerce.
930Erro na comunicação com a Visa Checkout.
934Erro na autorizadora Masterpass ao transacionar.
940Transação negada pela GetNet WS.
941Usuário não autenticado na GetNet WS.
942Nome de usuário inválido.
943Senha inválida.
944Id do comerciante inválido.
945Faixa de ID do comerciante.
946ID do terminal.
947Campo de cartão nulo.
948Id de pagamento nulo.
949PARes nulo.
950Transação negada pela Global Payments WS.
951Requisição nula.
952Código de comerciante inválido.
953Terminal inválido.
954Assinatura inválida.
970Transação negada pela SafetyPay.
971Motivo de reembolso nulo.
972Credencial nula.
980Titular do cartão nulo.
981Chave de pedido nula.
989Instituição antifraude inválida para notificar.
990ID de comerciante nulo.
991Código de comerciante nulo.
992Tipo de pagamento inválido para antifraude.
993Autorizadora inválida para antifraude.
994Pagamento Split não permitido para antifraude.
995Transação do tipo recarga não permitida para antifraude.
996Entidade para análise antifraude não cadastrada.
997Loja sem permissão para antifraude.
998Análise antifraude rejeitada, inválida ou em revisão.
999Item id do antifraude nulo.
1000Erro inesperado no Pagamento Online. Entre em contato com o suporte.
1003Erro inesperado no Pagamento Online. Entre em contato com o suporte.
1004Erro inesperado no Pagamento Online. Entre em contato com o suporte.
1010Erro inesperado de acesso à base de dados do Pagamento Online. Entre em contato com o suporte.
1032Nenhum resultado encontrado.
2000Erro inesperado no Pagamento Online. Entre em contato com o suporte.
5555Erro inesperado no Pagamento Online. Entre em contato com o suporte.

Parâmetros de requisição#

Na tabela abaixo está a descrição dos parâmetros de requisição do serviço de efetivação de pagamento com múltiplos meios de pagamento:

ParâmetroDescriçãoFormatoObrigatório
multiple_payment_methods[]Consiste em um array para pagamentos com múltiplos meios de pagamento em que cada item representa um meio de pagamento. Devem ser informados exatamente 2 (dois) itens, os quais são compostos pelos campos descritos abaixo.
authorizer_idCódigo da autorizadora no Pagamento Online. Saiba mais.
Caso este campo não tenha sido enviado na etapa de criação da transação, ele passa a ser obrigatório ao consumir o serviço de efetivação do pagamento.
< 3 NSIM
installmentsNúmero de parcelas. Caso não seja informado, será usado o valor passado na inicialização da transação no Pagamento Online.< 2 NNÃO
installment_typeTipo de financiamento. Caso não seja informado, será usado o valor passado na inicialização da transação no Pagamento Online.< 2 NNÃO
amountValor da compra especificado pela loja para este meio de pagamento (em centavos).< 12 NSIM
numberNúmero do cartão do comprador (PAN).< 19 NSIM
expiry_dateData de vencimento do cartão no formato MMAA. Sua obrigatoriedade depende do adquirente escolhido. Na maioria dos casos, esse campo é obrigatório.= 4 NCOND.
tokenHASH de um cartão armazenado no Pagamento Online. Não é permitido enviar um número de cartão aberto (campo number) e um cartão armazenado (campo token) na mesma requisição.= 88 ANNÃO
security_codeCódigo de segurança. Este campo pode não ser obrigatório se a empresa possuir um acordo no contrato firmado com as redes adquirentes, somente para o pagamento de determinados seguimentos.
Importante: um pagamento com agendamento implica no armazenamento dos dados do cartão do comprador no ambiente do Pagamento Online. Porém, por questões de segurança, o código de segurança não pode ser armazenado. Por isso, os pagamentos agendados sempre serão executados sem o envio do código de segurança.
< 5 NCOND.

Parâmetros de resposta#

Em caso de sucesso, o código de resposta HTTP será 201. Qualquer outro código deve ser interpretado como erro. Na tabela abaixo está a descrição dos parâmetros de resposta do serviço de efetivação de pagamento:

ParâmetroDescriçãoFormato
codeCódigo de resposta do Pagamento Online para a operação de múltiplos meios de pagamento. Qualquer código diferente de 0 significa falha. Saiba mais.< 4 N
messageMensagem de resposta do Pagamento Online para a operação de múltiplos meios de pagamento.< 500 AN
payments[]Consiste em um array para pagamentos com múltiplos meios de pagamento no qual cada item representa a resposta correspondente a um dos meios de pagamentos. Os itens são compostos pelos campos descritos abaixo.
codeCódigo de resposta do Pagamento Online para a operação de pagamento de um dos meios de pagamento. Qualquer código diferente de 0 significa falha. Saiba mais.< 4 N
messageMensagem de resposta do Pagamento Online para a operação de pagamento de um dos meios de pagamento.< 500 AN
authorizer_codeCódigo de resposta do autorizador.< 10 AN
authorizer_messageMensagem de resposta do autorizador.< 500 AN
statusStatus da transação de pagamento no Pagamento Online. Saiba mais.= 3 AN
nitIdentificador da transação de pagamento no Pagamento Online.= 64 AN
order_idCódigo de pedido enviado pela loja na criação da transação.< 20 AN
merchant_usnNúmero sequencial único enviado pela loja na criação da transação.< 12 N
amountValor da compra especificado pela loja para este meio de pagamento (em centavos).< 12 N
sitef_usnNúmero sequencial único da transação de pagamento no SiTef.= 6 N
esitef_usnNúmero sequencial único da transação de pagamento no Pagamento Online.= 15 N
customer_receiptCupom (via cliente).< 4000 AN
merchant_receiptCupom (via estabelecimento).< 4000 AN
authorizer_idCódigo da autorizadora utilizada na transação.< 4 N
acquirer_idCódigo do adquirente utilizado na transação.< 4 N
acquirer_nameNome do adquirente utilizado na transação.< 100 AN
authorizer_dateData de efetivação do pagamento retornada pelo autorizador no formato DD/MM/AAAA'T'HH:mm. Exemplo: 13/07/2017T16:03= 16 D
authorization_numberNúmero de autorização.< 6 AN
host_usnNSU da autorizadora.< 15 AN
tidID da transação no adquirente. Este campo só é retornado em transações com adquirentes externos ao SiTef.< 40 AN
eciEletronic Commerce Indicator (indicador do nível de segurança da transação do pagamento via Cielo e-Commerce).< 3 AN
payment_dateData de efetivação do pagamento no Pagamento Online no formato DD/MM/AAAA'T'HH:mm. Exemplo: 13/07/2017T16:03= 16 D
issuerCódigo da bandeira retornado pelo autorizador.< 5 AN
authorizer_merchant_idCódigo de afiliação do lojista na autorizadora.< 100 AN
xidCampo XID retornado em autenticações 3DS ou certos adquirentes.< 40 AN
authentication_urlURL de autenticação retornada em fluxos de pagamento com autenticação. Disponível apenas para Cielo e-Commerce.< 56 AN
balanceSaldo disponível após pagamentos com cartões tipo Gift.< 12 N
payment.analysis
codeCódigo de resposta da operação de análise de fraude.< 4 N
messageMensagem de resposta da operação de análise de fraude.< 200 AN
statusStatus da transação de análise de fraude do Pagamento Online. Este campo pode assumir os seguintes valores:
NOV – Nova.
EXP – Expirada.
ACC – Aceita
REJ – Rejeitada
REV – Em revisão
INV – Inválida
= 3 AN