Billing Information
End User

Assign Billing Information for an End User

This endpoint is a flexible tool designed to collect additional information required for ad-hoc workflows, such as billing or regulatory reporting. The flexibility of the endpoint allows the payload format to be customized according to the specific use case, as agreed upon with the partner.

Key aspects:

  • Negotiated Format: The info field format must be negotiated with the client before usage to ensure it meets the requirements of the specific use case.
  • Validation: Validation rules for the info payload may vary depending on the format and purpose of the data being submitted.
  • Versatility: This endpoint is not limited to billing information but can be repurposed for other ad-hoc workflows requiring custom data exchange.
  • Support for Data Corrections: This endpoint can also be invoked to rectify previously submitted data. If multiple rectifications are sent, the system will always use the most recent rectification received.

Use Case Example: Regulatory Reporting in Argentina

A common use case for this endpoint is to collect information for regulatory reporting, such as meeting compliance requirements for Argentina's Financial Information Unit (UIF). In this scenario, the required format for the info field is as follows:

Field Descriptions:

  • condición_extranjero (boolean): Indicates if the person is a foreign resident (true) or not (false).
  • cuit (string): Unique Tax Identification Code (Clave Única de Identificación Tributaria) of the person.
  • apellidos (string): Last name(s) of the person.
  • nombres (string): First name(s) of the person.
  • tipo_documento (string): Type of document (DNI, PASAPORTE).
  • num_documento (string): Document number.
  • nacionalidad (string): Nationality of the person.
  • fecha_nac (string): Date of birth in the format DD/MM/YYYY.
  • fecha_alta (string): Registration date in the format DD/MM/YYYY.
  • fecha_baja (string | null): Deregistration date in the format DD/MM/YYYY or null if not applicable.
  • es_pep (boolean): Indicates if the person is a Politically Exposed Person (true or false).
put/api/v1/end-users/{end_user_id}/billing/

Request

  • Base URL: https://sandbox-b2b.ripio.com
  • URL: https://sandbox-b2b.ripio.com/api/v1/end-users/{end_user_id}/billing/
  • Auth: OAuth 2 (client credentials, token URL https://sandbox-b2b.ripio.com/oauth2/token/)

Request body

infoobject required

JSON object which can hold arbitrary data based on the negotiated requirements between the client and the system.

Response

Successful response

end_user_idstring

Unique identifier for the end user.

Changes

No recorded changes to this operation across all 1 revision of this API.