Skip to main content

CreateClientRequest

paymentHubIdintegerrequired

ID of the PaymentHub to associate the client with. The hub must have dedicated client CVUs enabled.

Example: 4
namestringrequired

Full legal name of the client.

Possible values: <= 255 characters

Example: Acme SA
taxIdstringrequired

Tax identification number (CUIT) of the client.

Possible values: <= 64 characters

Example: 30-12345678-9
cashinCallbackUrluri

Your webhook URL to receive notifications when this client receives a bank transfer. Basilic will POST the event payload to this URL.

Example: https://tu-sistema.com/webhooks/cashin
emailsemail[]

List of contact email addresses for the client.

Example: ["contacto@acme.com"]
phonesstring[]

List of contact phone numbers for the client.

Example: ["+541112345678"]
aliasPrefixHintstring

Suggested prefix for the CVU alias. The final alias is assigned by the banking provider.

Possible values: <= 30 characters

Example: acmesa
aliasSuffixHintstring

Optional middle segment of the CVU alias, placed between the prefix and the hub brand suffix. Example: prefix.suffixHint.hubBrand

Possible values: <= 20 characters

Example: 555
externalReferencestring

Your internal reference or ID for this client (e.g., from your ERP or CRM).

Possible values: <= 255 characters

Example: ERP-001
metadata object

Arbitrary key/value pairs for your own use.

property name*any

Arbitrary key/value pairs for your own use.

CreateClientRequest
{
  "paymentHubId": 4,
  "name": "Acme SA",
  "taxId": "30-12345678-9",
  "cashinCallbackUrl": "https://tu-sistema.com/webhooks/cashin",
  "emails": [
    "contacto@acme.com"
  ],
  "phones": [
    "+541112345678"
  ],
  "aliasPrefixHint": "acmesa",
  "aliasSuffixHint": "555",
  "externalReference": "ERP-001",
  "metadata": {}
}