starkbank v2.6.1 StarkBank.Institution View Source
Groups Institution related functions
Link to this section Summary
Functions
This resource is used to get information on the institutions that are recognized by the Brazilian Central Bank. Besides the display name and full name, they also include the STR code (used for TEDs) and the SPI Code (used for Pix) for the institutions. Either of these codes may be empty if the institution is not registered on that Central Bank service.
Receive a list of Institution objects that are recognized by the Brazilian Central bank for Pix and TED transactions
Same as query(), but it will unwrap the error tuple and raise in case of errors.
Link to this section Types
Link to this section Functions
This resource is used to get information on the institutions that are recognized by the Brazilian Central Bank. Besides the display name and full name, they also include the STR code (used for TEDs) and the SPI Code (used for Pix) for the institutions. Either of these codes may be empty if the institution is not registered on that Central Bank service.
Attributes:
:display_name
[string]: short version of the institution name that should be displayed to end users. ex: "Stark Bank":name
[string]: full version of the institution name. ex: "Stark Bank S.A.":spi_code
[string]: SPI code used to identify the institution on Pix transactions. ex: "20018183":str_code
[string]: STR code used to identify the institution on TED transactions. ex: "123"
Receive a list of Institution objects that are recognized by the Brazilian Central bank for Pix and TED transactions
Options:
:limit
[integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35:search
[string, default nil]: part of the institution name to be searched. ex: "stark":spi_codes
[list of strings, default nil]: list of SPI (Pix) codes to be searched. ex: ["20018183"]:str_codes
[list of strings, default nil]: list of STR (TED) codes to be searched. ex: ["260"]:user
[Organization/Project, default nil]: Organization or Project struct returned from StarkBank.project(). Only necessary if default project or organization has not been set in configs.
Return:
- list of Institution objects with updated attributes
Same as query(), but it will unwrap the error tuple and raise in case of errors.