Create Fiat Account
This endpoint allows you to create a Fiat Account.
A Fiat Account allows an end user to transfer FIAT money to ripio B2B environment. Such money will be used, later, to fulfill orders. While a process or flow may be technically feasible, it does not necessarily mean it is legally, financially, or operationally viable. These aspects must be reviewed and validated by the respective areas before implementation.
The personal information that will be used to create the Fiat Account is the information that was uploaded in the KYC process. See: Create KYC Submission.
This endpoint behaves asynchronously, don’t expect the Fiat Account to be created after the request execution. To check for its completion, use the Retrieve Fiat Account endpoint.
When the fiat account is created, a webhook will be sent. See BaaS Webhook in the documentation.
Authorizations
B2B’s White Label API uses OAuth2. Currently there is only one supported authentication flow:
- clientCredentials allows you to access your own B2B account (First-Party Integration) and performs transactions against the public API. This oauth2 flow is well suited for this API, as it allows machine-to-machine communication.
Every call to the API has to be authenticated with an OAuth2 Token. In order to request this token, you will need to have sandbox or production API Keys (client id and client secret) that will be needed to generate a credential in order to negotiate an ephemeral access token.
Every request must be accompianed by an Authorization
header with a value that follows the following schema: Bearer ACCESS_TOKEN
Path Parameters
End user's external ref, usually a uuid.
Body
It indicates the account type. Usually bank_transfer.
Response
UUID4 formated unique id.
"123e4567-e89b-12d3-a456-4bedc4266abc"
ISO DateTime indicating Fiat Account creation date
"2019-08-24T14:15:22Z"
It defines the currency that the Fiat Account accepts.
3
"ARS"
JSON fields with account identification details. It varies based on the account type. Example:
{"cvu": "0000465160000000013330"}
Indicates the payment method type. Usually, bank_transfer.
Indicates the Fiat Account status. Only when "ENABLED", the fiat payment instructions will be provided.
PROCESSING
, ENABLED
End user's external ref