CONTEÚDO
Este endpoint é utilizado para realizar o pagamento de pedidos, via API Order Cartão Consumo.
| Método | URL |
|---|---|
| POST | https://api-barramento.meuelevestage.com/order/payment |
01. Corpo da requisição de envio do processamento de um pagamento:
{
"integrationHubServiceId": "03a93e31-1196-454b-b66f-55b7b636433",
"orderKeyType": "CARD",
"orderKey": "2",
"paymentObject": {
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 67.10,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 61.0,
"discounts": 0.00,
"fees": 6.10,
"total": 67.10
}
} |
O seu pedido foi aceite, mas ainda não foi processado, aguarde alguns instantes e contacte o mesmo endereço para obter o resultado do pagamento da encomenda solicitada. |
02. Retorno da requisição do processamento do pagamento:
{
"errors": [
{
"key": "orderKeyType_orderKey",
"message": "Order Payment request already exists: CARD-2"
}
]
} |
Sua solicitação foi aceita mas ainda não processada, aguarde alguns instantes e procure o status. |
03. Retorno da requisição após realização do processamento do pagamento e emissão da NFCe:
{
"integrationHubServiceId": "03a93e31-1196-454b-b66f-55b7b636433",
"success": true,
"orderKeyType": "CARD",
"orderKey": "2",
"paymentObject": {
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 76.89,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 69.9,
"discounts": 0,
"fees": 6.99,
"total": 76.89
},
"invoiceDetails": {
"orderXML": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\" ><NFe><infNFe versao=\"4.00\" Id=\"NFe35240982373077000171650010004112671177509557\"><ide><cUF>35</cUF><cNF>17750955</cNF><natOp>VENDA</natOp><mod>65</mod><serie>1</serie><nNF>411267</nNF><dhEmi>2024-09-10T12:02:09-03:00</dhEmi><tpNF>1</tpNF><idDest>1</idDest><cMunFG>3525904</cMunFG><tpImp>4</tpImp><tpEmis>1</tpEmis><cDV>7</cDV><tpAmb>2</tpAmb><finNFe>1</finNFe><indFinal>1</indFinal><indPres>1</indPres><procEmi>0</procEmi><verProc>03.2411.</verProc></ide><emit><CNPJ>82373077000171</CNPJ><xNome>ALBINO LTDA</xNome><xFant>BOTECO DO ALBINO</xFant><enderEmit><xLgr>AMELIA LATURRE</xLgr><nro>100</nro><xBairro>CENTRO</xBairro><cMun>3525904</cMun><xMun>JUNDIAI</xMun><UF>SP</UF><CEP>13211815</CEP><cPais>1058</cPais><xPais>BRASIL</xPais><fone>4145838800</fone></enderEmit><IE>128571670117</IE><IM>65656565</IM><CRT>3</CRT></emit><det nItem=\"1\"><prod><cProd>001</cProd><cEAN>SEM GTIN</cEAN><xProd>NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL</xProd><NCM>22021000</NCM><CEST>0300600</CEST><indEscala>S</indEscala><CFOP>5405</CFOP><uCom>UN</uCom><qCom>1.0000</qCom><vUnCom>69.9000</vUnCom><vProd>69.90</vProd><cEANTrib>SEM GTIN</cEANTrib><uTrib>UN</uTrib><qTrib>1.0000</qTrib><vUnTrib>69.9000</vUnTrib><indTot>1</indTot></prod><imposto><vTotTrib>25.50</vTotTrib><ICMS><ICMS60><orig>0</orig><CST>60</CST></ICMS60></ICMS><PIS><PISNT><CST>07</CST></PISNT></PIS><COFINS><COFINSNT><CST>07</CST></COFINSNT></COFINS></imposto></det><det nItem=\"2\"><prod><cProd>999</cProd><cEAN>SEM GTIN</cEAN><xProd>TAXA SERVICO</xProd><NCM>22021000</NCM><CFOP>5102</CFOP><uCom>UN</uCom><qCom>6.9900</qCom><vUnCom>1.0000</vUnCom><vProd>6.99</vProd><cEANTrib>SEM GTIN</cEANTrib><uTrib>UN</uTrib><qTrib>6.9900</qTrib><vUnTrib>1.0000</vUnTrib><indTot>1</indTot></prod><imposto><vTotTrib>2.23</vTotTrib><ICMS><ICMS00><orig>0</orig><CST>00</CST><modBC>3</modBC><vBC>6.99</vBC><pICMS>3.0000</pICMS><vICMS>0.21</vICMS></ICMS00></ICMS><PIS><PISNT><CST>07</CST></PISNT></PIS><COFINS><COFINSNT><CST>07</CST></COFINSNT></COFINS></imposto></det><total><ICMSTot><vBC>6.99</vBC><vICMS>0.21</vICMS><vICMSDeson>0.00</vICMSDeson><vFCP>0.00</vFCP><vBCST>0.00</vBCST><vST>0.00</vST><vFCPST>0.00</vFCPST><vFCPSTRet>0.00</vFCPSTRet><vProd>76.89</vProd><vFrete>0.00</vFrete><vSeg>0.00</vSeg><vDesc>0.00</vDesc><vII>0.00</vII><vIPI>0.00</vIPI><vIPIDevol>0.00</vIPIDevol><vPIS>0.00</vPIS><vCOFINS>0.00</vCOFINS><vOutro>0.00</vOutro><vNF>76.89</vNF><vTotTrib>27.73</vTotTrib></ICMSTot></total><transp><modFrete>9</modFrete></transp><pag><detPag><indPag>0</indPag><tPag>03</tPag><vPag>76.89</vPag><card><tpIntegra>2</tpIntegra></card></detPag><vTroco>0.00</vTroco></pag><infAdic><infCpl>Cartao: 382 Pedido:130 TOTVS CHEF Aplicativo: TOTVS Chef 03.2411. Serie: 96736041 Valor aproximado dos tributos deste cupom: Federal: R$ 13.89 Estadual: R$ 13.84 Municipal: R$ 0.00 Fonte IBPT/empresometro.com.br SP 19CB11</infCpl><obsCont xCampo=\"Series\"><xTexto>MDAxMDAwNDExMjY3MDAxMDAwNDExMjY3</xTexto></obsCont></infAdic><infRespTec><CNPJ>82373077000171</CNPJ><xContato>Renato Alves</xContato><email>[email protected]</email><fone>1120997271</fone></infRespTec></infNFe><infNFeSupl><qrCode><![CDATA[https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35240982373077000171650010004112671177509557|2|2|3|18D0E6CEA01007DA59D0C5B087141254ACB2AC88]]></qrCode><urlChave>https://www.homologacao.nfce.fazenda.sp.gov.br/consulta</urlChave></infNFeSupl><Signature xmlns=\"http://www.w3.org/2000/09/xmldsig#\"><SignedInfo><CanonicalizationMethod Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n-20010315\"/><SignatureMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#rsa-sha1\"/><Reference URI=\"#NFe35240982373077000171650010004112671177509557\"><Transforms><Transform Algorithm=\"http://www.w3.org/2000/09/xmldsig#enveloped-signature\"/><Transform Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n-20010315\"/></Transforms><DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\"/><DigestValue>IT5qHUAbxCoarZBHtQ0QrRzlysc=</DigestValue></Reference></SignedInfo><SignatureValue>Ow2g9BwM1Xza7ycVR6dhtObwTHMxEaVT3eJgyHJEjln1z1Jarv/k7EBJG87bad+94YXGM72NYC1d7mZt+zMGtPI/z/891RU5RhdydA3lm1a09TQao3+IK6+zngzhyFEWbykGnawGbrbPtuOWZY4ThAeJ+Ck3BtyYtE0SWCdUgvS+xVb0SFPvsMIU9GO8NTAD4HBZm97RPU1e/Fo2dJKFdILJSA0OqeHZHXMddibzAb0S20Ty+PgpENbaqAQuciI9qpuuLxAgmhEQcBIt+kS/pw96JOUA4HSXLZ45JoUkEuSfjKrdDvkNt+pqa1Zfmt0mwp28DSTEX/braxfQiqX5cw==</SignatureValue><KeyInfo><X509Data><X509Certificate>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</X509Certificate></X509Data></KeyInfo></Signature></NFe><protNFe versao=\"4.00\"><infProt><tpAmb>2</tpAmb><verAplic>SP_NFCE_PL_009_V400</verAplic><chNFe>35240982373077000171650010004112671177509557</chNFe><dhRecbto>2024-09-10T12:02:12-03:00</dhRecbto><nProt>135240002240081</nProt><digVal>IT5qHUAbxCoarZBHtQ0QrRzlysc=</digVal><cStat>100</cStat><xMotivo>Autorizado o uso da NF-e</xMotivo></infProt></protNFe></nfeProc>",
"invoiceKey": "35240982373077000171650010004112671177509557",
"qrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35240982373077000171650010004112671177509557|2|2|3|18D0E6CEA01007DA59D0C5B087141254ACB2AC88"
},
"error": null
} |
JSON de Pagamento de PedidoEste JSON é utilizado para enviar informações de pagamento relacionadas a um pedido por meio de um serviço de integração. Ele inclui informações sobre a chave de identificação da integração, tipo e chave do pedido, além de um objeto de pagamento detalhado. Campos:
|
integrationHubServiceId: é um código da integração da loja com o Integration Hub orderKey: é o código do pedido |
A seguir, alguns dos erros comuns que podem ser apresentados ao lidar com requisições HTTP e suas respectivas respostas:
O código de status HTTP 400, conhecido como "Bad Request" (Requisição Inválida), indica que o servidor não pôde processar a requisição do cliente devido a uma sintaxe inválida, estrutura malformada ou dados inválidos presentes na requisição.
01. Formando inválido do JSON esperado.
{
"integrationHubServiceId": "03a93e31-1196-454b-b66f-55b7b636433",
"orderKeyType": "CARD",
"orderKey": 2,
"paymentObject": {
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 67.10,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 61.0,
"discounts": 0.00,
"fees": 6.10,
"total": 67.10
}
} |
{
"errors": [
{
"key": "orderKey",
"message": "body.orderKey must be a string"
}
]
} |
02. JSON enviando faltando um ou mais campos.
{
"integrationHubServiceId": "03a93e31-1196-454b-b66f-55b7b636433",
"orderKey": "2",
"paymentObject": {
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 67.10,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 61.0,
"discounts": 0.00,
"fees": 6.10,
"total": 67.10
}
} |
{
"errors": [
{
"key": "orderKeyType",
"message": "body.orderKeyType is required"
}
]
} |
03. GUID incorreto
{
"integrationHubServiceId": "03a93e31-1196-454b-b66f-55b7b63643A",
"orderKey": "2",
"paymentObject": {
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 67.10,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 61.0,
"discounts": 0.00,
"fees": 6.10,
"total": 67.10
}
} |
{
"errors": [
{
"key": "integrationHubServiceId",
"message": "body.integrationHubServiceId must be a valid GUID"
}
]
} |
A solicitação é inválida e não pôde ser processada devido a erros na entrada fornecida. Verifique os dados enviados e tente novamente. |
O código de status HTTP 401, conhecido como "Unauthorized" (Não Autorizado), indica que a requisição não foi aplicada porque carece de credenciais de autenticação válidas para o recurso alvo. Diferente do código 403 (Forbidden), que significa que o servidor entendeu a requisição, mas se recusa a autorizá-la, o 401 é usado especificamente quando a autenticação é necessária e falhou ou ainda não foi fornecida.
A solicitação não pôde ser processada porque o usuário não possui as permissões necessárias. Verifique suas credenciais e tente novamente. |
O código de status HTTP 403, conhecido como "Forbidden" (Proibido), indica que o Token de autenticação ausente.
O código de status HTTP 404, conhecido como "Not Found" (Não Encontrado), indica que o servidor não encontrou o recurso solicitado. Isso pode ocorrer quando o integrationHubId está incorreto ou inválido.
{
"integrationHubServiceId": "02990348-9d85-416d-a573-6dc83eee52e7",
"orderKeyType": "TABLE",
"orderKey": "2",
"paymentObject": {
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 67.10,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 61.0,
"discounts": 0.00,
"fees": 6.10,
"total": 67.10
}
} |
{
"errors": [
{
"key": "integrationHubServiceId",
"message": "Provider Merchant for integrationHubServiceId \"02990348-9d85-416d-a573-6dc83eee52e7\" not found or disabled"
}
]
} |
IntegrationHubId incorreto ou inválido |
O código de status HTTP 412, conhecido como "Precondition Failed" (Pré-condição Falhou), Alguma regra para atendimento de sua solicitação não foi atendida, analise o corpo da declaração para saber os motivos. para saber os motivos.
O código de status HTTP 429, conhecido como "Too Many Requests" (Muitas Requisições), indica que o cliente excedeu o limite de requisições permitido para um determinado período de tempo. Esse limite é definido pelo servidor e pode variar de acordo com a política de limitação de taxa implementada.
{
"integrationHubServiceId": "03a93e31-1196-454b-b66f-55b7b63643",
"orderKeyType": "CARD",
"orderKey": "383",
"paymentObject": {
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 76.89,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 69.90,
"discounts": 0.00,
"fees": 6.99,
"total": 76.89
}
} |
{
"printOrderAtPos": true,
"generateInvoice": true,
"printInvoiceAtPos": true,
"sendInvoiceEmail": false,
"summaryExtract": false,
"customerDocument": null,
"documentInReceipt": false,
"numberPersons": 1,
"removeServiceFee": false,
"methods": [
{
"value": 76.89,
"currency": "BRL",
"type": "OFFLINE",
"method": "CREDIT",
"methodInfo": "VISA"
}
],
"orderAmount": 69.9,
"discounts": 0,
"fees": 6.99,
"total": 76.89
} |
Alguma regra para atender ao seu pedido não foi cumprida; analise o corpo da resposta para descobrir as razões. |