{"id":2277,"date":"2026-09-11T17:29:22","date_gmt":"2026-09-11T20:29:22","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&p=2277"},"modified":"2026-09-11T18:26:55","modified_gmt":"2026-09-11T21:26:55","slug":"representacao-de-pagamento","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=representacao-de-pagamento","title":{"rendered":"Representa\u00e7\u00e3o de Pagamento"},"content":{"rendered":"\n

1. Endpoint<\/h2>\n\n\n\n
PUT https:\/\/hmlapi2.bancosemear.com.br\/caas-api-status\/v1\/public\/proposals\/:contractId\/bank-data<\/code><\/pre>\n\n\n\n
2. Descri\u00e7\u00e3o<\/h2>\n\n\n\n
API destinada \u00e0 reapresenta\u00e7\u00e3o de pagamentos com erro ou diverg\u00eancia, permitindo uma nova tentativa de processamento de forma controlada, segura e rastre\u00e1vel, vinculada ao pagamento original. O cliente receber\u00e1 um webhook (worker_credit.disbursement) informando que houve diverg\u00eancias de dados banc\u00e1rios no pagamento, ou poder\u00e1 consultar a API de Status. Ap\u00f3s isso, ele poder\u00e1 realizar a reapresenta\u00e7\u00e3o do pagamento, corrigindo os dados. Caso os dados n\u00e3o sejam corrigidos no per\u00edodo de 3 dias<\/strong>, a proposta ser\u00e1 cancelada automaticamente e desaverbada na Dataprev.<\/p>\n\n\n\n
3. Headers<\/h2>\n\n\n\n
Key<\/strong><\/td>Valor (apenas exemplo)<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
client_id<\/td>00000000-0000-0000-0000-000000000000<\/code><\/td>Identificador \u00fanico do cliente\/aplica\u00e7\u00e3o consumidora da API<\/td><\/tr>
access_token<\/td>00000000-0000-0000-0000-000000000000<\/code><\/td>Token de acesso Bearer\/JWT com escopo de
autoriza\u00e7\u00e3o<\/td><\/tr>
Content-Type<\/td>application\/json<\/td>Formato do corpo da requisi\u00e7\u00e3o<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
4. Request Body<\/h2>\n\n\n\n
{\n  \"bankId\": \"001\",\n  \"accountType\": \"checking\",\n  \"agency\": \"1234\",\n  \"agencyDigit\": \"5\",\n  \"account\": \"123456\",\n  \"accountDigit\": \"7\"\n}<\/code><\/pre>\n\n\n\n
Obs.: Deve-se preencher o parametro contractId <\/strong>na rota:
Ex.: \/caas-api-status\/v1\/public\/proposals\/c0aae62c-1ae3-4fcf-bca2-a225c14d292c<\/strong>\/bank-data<\/p>\n\n\n\n
4.1. Tabela de campos<\/strong><\/p>\n\n\n\n
Campo<\/th>Tipo<\/th>Obrigat\u00f3rio*<\/th>Regras<\/th>Descri\u00e7\u00e3o<\/th><\/tr><\/thead>
bankId<\/code><\/td>string<\/td>Sim<\/td>Somente n\u00fameros<\/td>C\u00f3digo Banc\u00e1rio<\/td><\/tr>
accountType<\/code><\/td>string<\/td>Sim<\/td>\u2014<\/td>Tipo de conta:

checking = conta corrente
savings = conta poupan\u00e7a<\/td><\/tr>
agency<\/code><\/td>string<\/td>Sim<\/td>
Somente n\u00fameros<\/td>		N\u00famero da ag\u00eancia<\/td><\/tr>
agencyDigit<\/code><\/td>string<\/td>N\u00e3o<\/td>\u2014<\/td>N\u00famero do d\u00edgito da ag\u00eancia<\/td><\/tr>
account<\/td>string<\/td>Sim<\/td>
Somente n\u00fameros<\/td>		N\u00famero da conta<\/td><\/tr>
accountDigit<\/td>string<\/td>N\u00e3o<\/td>\u2014<\/td>N\u00famero do d\u00edgito da conta<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
5. Respostas esperadas<\/h2>\n\n\n\n
5.1.\u00a0200 \u2014 Sucesso<\/strong><\/p>\n\n\n\n
Retornado quando os dados banc\u00e1rios s\u00e3o atualizados e o pagamento \u00e9 reprocessado automaticamente em seguida.<\/p>\n\n\n\n
\"Enviando corre\u00e7\u00e3o de dados banc\u00e1rios para a esteira de pagamento.\"<\/code><\/pre>\n\n\n\n
5.2.\u00a0(400)\u00a0\u2014 Requisi\u00e7\u00e3o inv\u00e1lida<\/strong><\/p>\n\n\n\n
Retornado quando ocorre algum erro ao buscar os dados de pagamento do cliente.<\/p>\n\n\n\n
Falha ao atualizar dados banc\u00e1rios na esteira de pagamento.<\/code><\/pre>\n\n\n\n
5.3.\u00a0500 \u2014 Erro inesperado<\/strong><\/p>\n\n\n\n
\"Falha de comunica\u00e7\u00e3o com a esteira de pagamento.\"<\/code><\/pre>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
1. Endpoint 2. Descri\u00e7\u00e3o API destinada \u00e0 reapresenta\u00e7\u00e3o de pagamentos com erro ou diverg\u00eancia, permitindo uma nova tentativa de processamento de forma controlada, segura e rastre\u00e1vel, vinculada ao pagamento original. O cliente receber\u00e1 um webhook (worker_credit.disbursement) informando que houve diverg\u00eancias de dados banc\u00e1rios no pagamento, ou poder\u00e1 consultar a API de Status. Ap\u00f3s isso, ele …<\/p>\n
  Representa\u00e7\u00e3o de Pagamento<\/span> Leia mais »<\/a><\/p>\n","protected":false},"author":23,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-global-header-display":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","footnotes":""},"doc_category":[55],"doc_tag":[],"class_list":["post-2277","docs","type-docs","status-publish","hentry","doc_category-consignado_inss"],"_links":{"self":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2277","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/users\/23"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2277"}],"version-history":[{"count":7,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2277\/revisions"}],"predecessor-version":[{"id":2304,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2277\/revisions\/2304"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2277"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=2277"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=2277"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}