Create a bank key
Changed onStores a new set of bank credentials for the company. Cardda encrypts the secrets at rest; this is the only entry point that accepts plain-text credentials. Upon creation Cardda runs an asynchronous validation against the bank — the key starts as pending; poll the resource until status flips to approved (or declined).
A credential can be shared across several companies. If you re-enter a credential you already own (same user_id + type, plus rut for CL/MX or email for US) and associate it to another company, Cardda attaches that company to the existing key instead of creating a duplicate — the response is 200 carrying the existing key (vs 201 for a brand-new key).
Request
- Base URLhttps://api.cardda.com
- AuthHTTP bearer
Parameters
Request body
Example request
{
"password": "qwerty",
"card": "1234567890123456",
"rut": "19"
}Response
Existing credential — you re-entered a credential you already own and it was associated to the requested company (or companies) instead of creating a duplicate. The body is the existing bank key.
Changes
- info
endpoint added
- info