Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Efí Pix Charges API

Immediate (cob) and dated (cobv) Pix charges and payload locations. Host pix.api.efipay.com.br, mTLS required.

Efí Pix Charges API is one of 7 APIs that Efí publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Pix Charges. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 8 operations across 4 paths, and defines 10 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against 4 base URLs: https://pix.api.efipay.com.br, https://pix-h.api.efipay.com.br, https://cobrancas.api.efipay.com.br, https://openfinance.api.efipay.com.br.

8 operations 4 paths 10 schemas 3 GET1 PATCH2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://pix.api.efipay.com.br
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Efí Pix Charges API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oAuth2ClientCredentials) using the clientCredentials flow, exposing 13 scopes. By default, every request must be authenticated.

  • oAuth2ClientCredentials — OAuth2 client-credentials. Obtain a bearer token from the host's token endpoint using HTTP Basic auth (ClientId / ClientSecret), then send it as Authorization:…

Paths & Operations 8

Across 4 paths, the API surfaces 8 operations — 3 GET, 1 PATCH, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Pix Charges 8

Immediate (cob) and dated (cobv) Pix charges and payload locations. Host pix.api.efipay.com.br, mTLS required.

POST
/v2/cob
Create an immediate Pix charge (server-generated txid)
createImmediateCharge body → 201401
GET
/v2/cob
List immediate Pix charges
listImmediateCharges 2 params → 200401
PUT
/v2/cob/{txid}
Create an immediate Pix charge with a given txid
createImmediateChargeWithTxid 1 param body → 201401
PATCH
/v2/cob/{txid}
Revise an immediate Pix charge
reviseImmediateCharge 1 param body → 200401
GET
/v2/cob/{txid}
Retrieve an immediate Pix charge
getImmediateCharge 1 param → 200401404
PUT
/v2/cobv/{txid}
Create a dated Pix charge (cobv)
createDatedCharge 1 param body → 201401
GET
/v2/cobv/{txid}
Retrieve a dated Pix charge (cobv)
getDatedCharge 1 param → 200401404
POST
/v2/loc
Create a payload location
createLocation body → 201401

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are CobRequest (5 properties), Error (4 properties), CobvRequest (4 properties), Devedor (3 properties). Each schema is shown below with its type and property counts.

CobvRequest
object
4 properties
LocationRequest
object
1 property
CobList
object
2 properties
Devedor
object
3 properties
Valor
object
1 property
CobRequest
object
5 properties
Cobv
Location
Error
object
4 properties
Cob

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

efi-bank-pix-charges-api-openapi.yml Raw ↑

Other APIs Efí publishes across the network.

Efí Authorization API
Efí Carnê API
Efí Cobranças API
Efí Open Finance API
Efí Pix Payments API
Efí Pix Webhooks API