> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Continuar onboarding

> Reanuda el onboarding de un destinatario después de proporcionar datos o documentación adicional requeridos

Continúa el proceso de onboarding de un destinatario. Este endpoint se usa en los flujos de onboarding de dos pasos para ejecutar el paso de KYC después de crear la cuenta.

Este endpoint continúa el proceso de onboarding de un destinatario y ejecuta específicamente el paso de KYC (Know Your Customer) en los flujos de onboarding de dos pasos. Úsalo cuando necesites completar la validación de KYC después de que la creación de la cuenta se haya completado mediante [Create Onboarding](https://docs.y.uno/es/reference/recipients-for-marketplace/create-onboarding.md).

## Requisitos previos

Este endpoint requiere una llamada previa a [Create Onboarding](https://docs.y.uno/es/reference/recipients-for-marketplace/create-onboarding.md) con `type: "TWO_STEP_ONBOARDING"`, en la que el paso de creación de la cuenta se haya completado correctamente. Este es el segundo paso en los [flujos de onboarding de dos pasos](https://docs.y.uno/es/reference/recipients-for-marketplace/create-onboarding.md) para el [marketplace de pagos divididos](https://docs.y.uno/es/docs/payment-features/split-payments-marketplace.md#/).

El proceso de continuación admite dos tipos de flujo de trabajo:

* **HOSTED\_BY\_PROVIDER**: devuelve una URL de redirección de Yuno que registra la actividad y redirige a la interfaz de KYC del proveedor. Usa `workflow: "HOSTED_BY_PROVIDER"`.
* **DIRECT**: procesa la validación de KYC directamente, sin redirecciones externas. Usa `workflow: "DIRECT"`.

## Envío de una cuenta bancaria

Para un destinatario existente de un proveedor Zoop o Pagar.me, un `withdrawal_methods.bank` explícito se confirma mediante la ruta de actualización bancaria antes de continuar con el KYC. Esto incluye la primera cuenta bancaria de un vendedor existente.

Después de que el proveedor confirma el banco, Yuno lo guarda para el onboarding seleccionado y continúa con el KYC sin volver a enviar el banco. El valor predeterminado del destinatario no cambia. Una actualización bancaria exitosa no significa que el KYC esté completo: el onboarding aún puede requerir documentos de identidad u otra información.

Un rechazo definitivo del banco devuelve `400`; un resultado sin confirmar devuelve `409`. En cualquiera de los dos casos, esa solicitud no inicia el KYC y el banco sin confirmar no se guarda. Sigue la [guía de errores bancarios y reintentos](https://docs.y.uno/es/reference/recipients-for-marketplace/update-recipient-1.md#bank-errors-and-retries) antes de reintentar. Si el banco se confirma pero un paso posterior del KYC falla, el cambio bancario no se revierte.

Otros proveedores y el onboarding inicial sin un ID de destinatario del proveedor mantienen su comportamiento de continuación existente.


## OpenAPI

````yaml openapi/es/recipients-for-marketplace/continue-onboarding.json POST /recipients/{recipient_id}/onboardings/{onboarding_id}/continue
openapi: 3.1.0
info:
  title: Recipients API
  version: 1.0.0
  description: >-
    API for managing recipients in split payment scenarios. This feature enables
    merchants to split payments among multiple recipients, which is particularly
    beneficial for marketplace models where transactions need to be divided
    among different sellers or stakeholders.
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /recipients/{recipient_id}/onboardings/{onboarding_id}/continue:
    parameters:
      - in: path
        name: recipient_id
        description: ID del destinatario
        schema:
          type: string
        required: true
        example: 9104911d-5df9-429e-8488-ad41abea1a4b
      - in: path
        name: onboarding_id
        description: ID del onboarding que se va a continuar
        schema:
          type: string
        required: true
        example: 9104911d-5df9-429e-8488-ad41abea1a4b
    post:
      summary: Continuar onboarding
      description: >-
        En los onboardings vinculados a proveedor de Zoop y Pagar.me, las
        actualizaciones bancarias explícitas esperan la confirmación del
        proveedor. Los resultados desconocidos devuelven 409; los cambios
        confirmados no se revierten. Consulta la guía del endpoint para el
        direccionamiento, los resultados parciales y las pautas de reintento.
      operationId: continue-onboarding
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - account_id
                - type
                - workflow
              properties:
                account_id:
                  type: string
                  description: ID único de la cuenta en Yuno
                  example: 9104911d-5df9-429e-8488-ad41abea1a4b
                type:
                  type: string
                  enum:
                    - TWO_STEP_ONBOARDING
                  description: >-
                    Tipo de flujo de onboarding. Solo se puede continuar
                    TWO_STEP_ONBOARDING.
                  example: TWO_STEP_ONBOARDING
                workflow:
                  type: string
                  enum:
                    - HOSTED_BY_PROVIDER
                    - DIRECT
                  description: >-
                    Flujo del proceso de KYC. HOSTED_BY_PROVIDER llama al
                    servicio de creación de KYC y devuelve una URL de Yuno que
                    redirige al proveedor. DIRECT llama al servicio de creación
                    de KYC y procesa el KYC directamente.
                  example: HOSTED_BY_PROVIDER
                callback_url:
                  type: string
                  format: uri
                  description: >-
                    URL a la que redirigir a tu cliente después del proceso de
                    onboarding con el proveedor, si es necesario.
                  example: https://www.google.com
                provider:
                  type: object
                  properties:
                    id:
                      type: string
                      description: ID del proveedor
                      example: PAGARME
                    connection_id:
                      type: string
                      description: ID de la conexión en Yuno
                      example: 104911d-5df9-429e-8488-ad41abea1a4b
                    recipient_id:
                      type: string
                      description: Identificador único del destinatario del proveedor.
                      example: AAAAA01
                documentation:
                  type: array
                  description: Especifica el objeto de documentación.
                  items:
                    type: object
                    required:
                      - file_name
                      - content_type
                      - content_category
                      - content
                    properties:
                      file_name:
                        type: string
                        minLength: 3
                        maxLength: 255
                        description: >-
                          El nombre de la documentación enviada (MAX 255; MIN
                          3).
                        example: PDF
                      content_type:
                        type: string
                        enum:
                          - application/pdf
                          - image/jpeg
                          - image/png
                        description: El tipo de documentación enviada por el comercio
                        example: application/pdf
                      content_category:
                        type: string
                        enum:
                          - ACCOUNT_REQUIREMENT
                          - BANK_STATEMENT
                          - BUSINESS_ICON
                          - BUSINESS_LOGO
                          - CANCEL_POLICY
                          - CUSTOMER_INTERACTION
                          - DRIVERS_LICENCE
                          - DRIVERS_LICENCE_BACK
                          - IDENTIFICATION_DOCUMENT
                          - IDENTIFICATION_DOCUMENT_BACK
                          - IDENTIFICATION_DOCUMENT_FRONT
                          - LEGAL_AGREEMENT
                          - OTHERS
                          - PASSPORT
                          - PAYMENT_DETAIL
                          - PROOF_OF_ADDRESS
                          - PROOF_OF_AUTHENTICITY
                          - PROOF_OF_DELIVERY
                          - PROOF_OF_DIRECTOR
                          - PROOF_OF_INDUSTRY
                          - PROOF_OF_NATIONAL_ID_NUMBER
                          - PROOF_OF_OWNERSHIP
                          - PROOF_OF_REGISTRATION
                          - PROOF_OF_RELATIONSHIP
                          - PROOF_OF_SERVICE
                          - PROOF_OF_SOURCE_OF_FUNDS
                          - PROOF_OF_SOURCE_OF_WEALTH
                          - PROOF_OF_TAX
                          - PROVIDER_IDENTITY_DOCUMENT
                          - RECEIPT
                          - REFUND_POLICY
                          - SELFIE
                          - SERVICE_AGREEMENT
                          - SIGNATURE
                          - TERMS_AND_CONDITIONS
                          - VAT_DOCUMENT
                        description: >-
                          La categoría de la documentación enviada por el
                          comercio
                      content:
                        type: string
                        format: byte
                        description: >-
                          Contenido de la documentación enviada por el comercio,
                          codificado en base64. Tamaño máximo: 1MB.
                        example: >-
                          JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==
                withdrawal_methods:
                  type: object
                  description: Especifica el objeto de métodos de retiro.
                  properties:
                    bank:
                      type: object
                      description: struct
                      properties:
                        code:
                          type: string
                          minLength: 3
                          maxLength: 3
                          description: Código del banco (MAX 3; MIN 3)
                          example: '246'
                        branch:
                          type: string
                          minLength: 3
                          maxLength: 3
                          description: Sucursal del banco (MAX 3; MIN 3)
                          example: XXXX
                        branch_digit:
                          type: string
                          minLength: 3
                          maxLength: 3
                          description: Dígito de la sucursal del banco (MAX 3; MIN 3)
                        account:
                          type: string
                          minLength: 3
                          maxLength: 250
                          description: >-
                            Número de cuenta bancaria del beneficiario (MAX 3;
                            MIN 250)
                          example: '1093333333'
                        account_digit:
                          type: string
                          minLength: 3
                          maxLength: 250
                          description: >-
                            Dígito de la cuenta bancaria del beneficiario (MAX
                            3; MIN 250)
                        account_type:
                          type: string
                          enum:
                            - CHECKINGS
                            - SAVINGS
                            - VISTA
                            - PIX_EMAIL
                            - PIX_PHONE
                            - PIX_DOCUMENT_ID
                            - PIX_BANK_ACCOUNT
                          description: >-
                            Tipo de cuenta bancaria del beneficiario (MAX 1; MIN
                            3). Puede ser: CHECKINGS, SAVINGS, VISTA, PIX_EMAIL,
                            PIX_PHONE, PIX_DOCUMENT_ID, PIX_BANK_ACCOUNT
                          example: SAVINGS
                        routing:
                          type: string
                          description: >-
                            Número de ruta de la cuenta bancaria del
                            beneficiario
                          example: XXXXYYYYC
                        country:
                          type: string
                          minLength: 2
                          maxLength: 2
                          description: País de la cuenta bancaria (ISO 3166-1 MAX 2; MIN 2)
                          example: CO
                        currency:
                          type: string
                          minLength: 3
                          maxLength: 3
                          description: >-
                            Moneda de la cuenta bancaria (ISO 3166-1 MAX 3; MIN
                            3)
                          example: COP
                legal_representatives:
                  type: array
                  description: >-
                    Objeto que indica los propietarios de la organización.
                    Adyen, Stripe y dlocal tienen campos relacionados con esto.
                  items:
                    type: object
                    required:
                      - merchant_reference
                    properties:
                      merchant_reference:
                        type: string
                        minLength: 3
                        maxLength: 255
                        description: >-
                          ID de identificación del representante legal (MAX 255;
                          MIN 3). Obligatorio: la API devuelve 400
                          INVALID_PARAMETERS ("The field
                          'legal_representatives[0].merchant_reference' is
                          required.") cuando falta.
                      first_name:
                        type: string
                        minLength: 1
                        maxLength: 255
                        description: Nombre del representante legal. (MAX 255; MIN 1).
                        example: John
                      last_name:
                        type: string
                        minLength: 1
                        maxLength: 255
                        description: Apellido del representante legal. (MAX 255; MIN 1).
                        example: Doe
                      email:
                        type: string
                        format: email
                        minLength: 1
                        maxLength: 255
                        description: Email del representante legal (MAX 255; MIN 1).
                        example: john.doe@email.com
                      date_of_birth:
                        type: string
                        format: date
                        minLength: 10
                        maxLength: 10
                        description: >-
                          Fecha de nacimiento del representante legal en formato
                          YYYY-MM-DD (MAX 10; MIN 10).
                        example: '1990-02-28'
                      country:
                        type: string
                        minLength: 2
                        maxLength: 2
                        description: País del representante legal (ISO 3166-1 MAX 2; MIN 2)
                        example: CO
                      nationality:
                        type: string
                        minLength: 2
                        maxLength: 2
                        description: >-
                          Nacionalidad del representante legal (MAX 2; MIN 2;
                          ISO 3166-1).
                        example: CO
                      title:
                        type: string
                        minLength: 1
                        maxLength: 255
                        description: Cargo del representante legal (MAX 255; MIN 1).
                        example: CTO
                      publicly_exposed_person:
                        type: boolean
                        description: >-
                          Indica si el representante legal es una persona
                          expuesta políticamente
                        example: false
                      ultimate_beneficial_owner:
                        type: boolean
                        description: >-
                          Indica si el representante legal es un beneficiario
                          final de la empresa
                        example: false
                terms_of_service:
                  type: object
                  description: Objeto que describe los términos de servicio.
                  required:
                    - acceptance
                    - date
                  properties:
                    acceptance:
                      type: boolean
                      description: Si el destinatario aceptó los términos de servicio
                      example: true
                    date:
                      type: string
                      format: date-time
                      description: Fecha de aceptación de los términos de servicio
                      example: '2022-07-09T20:43:54.786342Z'
                    ip:
                      type: string
                      format: ipv4
                      description: IP de aceptación de los términos de servicio
                      example: 192.168.1.100
            examples:
              Continue Two-Step Onboarding:
                value:
                  account_id: '{{account-code}}'
                  type: TWO_STEP_ONBOARDING
                  workflow: DIRECT
                  callback_url: https://merchant.example.com/webhook/onboarding
                  provider:
                    id: STRIPE
                    connection_id: '{{connection_id}}'
                  legal_representatives:
                    - merchant_reference: LR-0001
                      first_name: John
                      last_name: Doe
                      email: john.doe@email.com
                      date_of_birth: '1990-02-28'
                      country: CO
                      nationality: CO
                      title: CTO
                      publicly_exposed_person: false
                      ultimate_beneficial_owner: false
      responses:
        '201':
          description: Creado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipientResponse'
              examples:
                Successful:
                  value:
                    id: 61df26d9-3750-4206-baab-f2e20683f35b
                    type: TWO_STEP_ONBOARDING
                    workflow: HOSTED_BY_PROVIDER
                    status: PENDING
                    provider:
                      id: STRIPE
                      connection_id: 8fee3cc6-f3cb-455d-b139-973866111a03
                      recipient_id: acct_1RvpogA4Jk50vKRE
                      redirect_url: https://api.y.uno/redirect/kyc/stripe/session_12345
                    created_at: '2025-08-22T17:57:58.460711Z'
                    updated_at: '2025-08-22T18:15:22.123456Z'
                  summary: Successful
        '400':
          description: >-
            Solicitud no válida, rechazo bancario definitivo para el onboarding
            seleccionado, o un estado de onboarding que no acepta
            actualizaciones bancarias (INVALID_STATE). La continuación del KYC
            no se inicia cuando el banco rechaza. Un 400 también puede darse
            después de un cambio bancario confirmado cuando falla un paso
            posterior (REQUEST_CANNOT_BE_PROCESSED); lee los mensajes del
            resultado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Invalid Parameters:
                  value:
                    code: INVALID_PARAMETERS
                    messages:
                      - >-
                        Provider rejected or requires attention to field:
                        withdrawal_methods.bank.
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Unauthorized:
                  value:
                    code: INVALID_CREDENTIALS
                    messages:
                      - Invalid credentials
        '403':
          description: Prohibido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Forbidden:
                  value:
                    code: AUTHORIZATION_REQUIRED
                    messages:
                      - The merchant has no authorization to use this API.
        '409':
          description: >-
            Resultado bancario sin confirmar, o una operación de onboarding
            impide esta solicitud. Revisa el código y los mensajes; es posible
            que ya se haya producido un cambio confirmado en el proveedor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Unconfirmed bank update:
                  value:
                    code: PROVIDER_TIMEOUT_AMBIGUOUS
                    messages:
                      - >-
                        Provider ZOOP, onboarding
                        3f6c1a2e-8b4d-4c7e-9a1f-5d2e7b9c0a14: UNKNOWN.
                      - >-
                        The provider did not confirm this bank update. Inspect
                        the provider account before retrying; untrusted provider
                        diagnostics were omitted.
                      - >-
                        Unconfirmed outcomes require provider reconciliation
                        before a different bank is submitted. Resend the same
                        intended account after the approximately three-minute
                        cooldown.
                Operation in progress:
                  value:
                    code: ONBOARDING_OPERATION_IN_PROGRESS
                    messages:
                      - >-
                        A bank or onboarding operation is in progress. After an
                        unconfirmed result, reconcile the provider account
                        before resending the same intended account after about
                        three minutes.
components:
  schemas:
    RecipientResponse:
      type: object
      properties:
        id:
          type: string
          description: El identificador único del destinatario.
          example: 3aaa4d82-11e8-48ce-8ef5-04eee3a10802
        account_id:
          type: string
          description: El identificador de cuenta asociado a este destinatario.
          example: fe14c7c6-c75e-43b7-bdbe-4c87ad52c482
        merchant_recipient_id:
          type: string
          description: Identificador único del destinatario definido por el comercio.
          example: MERCHANT_182acf1d-faeb-4ff0-94cd-7fab11b282f6
        national_entity:
          type: string
          description: Tipo de entidad nacional del beneficiario.
          example: INDIVIDUAL
        entity_type:
          type: string
          description: Tipo de organización del beneficiario.
          example: PRIVATE
        first_name:
          type: string
          description: Nombre del beneficiario.
          example: Juan
        last_name:
          type: string
          description: Apellido del beneficiario.
          example: Perez
        legal_name:
          type:
            - string
            - 'null'
          description: Razón social del beneficiario.
          example: null
        email:
          type: string
          description: El correo electrónico del beneficiario.
          example: juan.perez@example.com
        date_of_birth:
          type: string
          description: Fecha de nacimiento del beneficiario.
          example: '1990-01-15'
        country:
          type: string
          description: El país del beneficiario.
          example: CO
        website:
          type: string
          description: La URL del sitio web del vendedor.
          example: https://juanperez.com
        industry:
          type: string
          description: El sector del vendedor.
          example: Technology
        merchant_category_code:
          type: string
          description: El código de categoría del comercio (MCC) (MAX 235; MIN 1).
          example: '5734'
        document:
          type: object
          properties:
            document_number:
              type: string
              example: '1234567890'
            document_type:
              type: string
              example: CC
        phone:
          type: object
          properties:
            country_code:
              type: string
              example: '57'
            number:
              type: string
              example: '3001234567'
        address:
          type: object
          properties:
            address_line_1:
              type: string
              example: 'Carrera 7 # 32-16'
            address_line_2:
              type:
                - string
                - 'null'
              example: Oficina 201
            city:
              type: string
              example: Bogota
            country:
              type: string
              example: CO
            state:
              type: string
              example: Cundinamarca
            zip_code:
              type: string
              example: '110311'
            neighborhood:
              type: string
              example: Centro
        legal_representatives:
          type: array
          items:
            type: object
            properties:
              merchant_reference:
                type: string
                example: REP_001
              first_name:
                type: string
                example: Maria
              last_name:
                type: string
                example: Gonzalez
              email:
                type: string
                example: maria.gonzalez@example.com
              date_of_birth:
                type: string
                example: '1985-05-20'
              country:
                type: string
                example: CO
              nationality:
                type: string
                example: CO
              title:
                type: string
                example: CEO
              publicly_exposed_person:
                type: boolean
                example: false
              ultimate_beneficial_owner:
                type: boolean
                example: true
              document:
                type: object
                properties:
                  document_type:
                    type: string
                    example: CC
                  document_number:
                    type: string
                    example: '0987654321'
              phone:
                type: object
                properties:
                  country_code:
                    type: string
                    example: '57'
                  number:
                    type: string
                    example: '3109876543'
              address:
                type: object
                properties:
                  address_line_1:
                    type: string
                    example: 'Calle 26 # 13-19'
                  address_line_2:
                    type:
                      - string
                      - 'null'
                    example: null
                  country:
                    type: string
                    example: CO
                  state:
                    type: string
                    example: Cundinamarca
                  city:
                    type: string
                    example: Bogota
                  zip_code:
                    type: string
                    example: '110311'
        withdrawal_methods:
          type: object
          properties:
            bank:
              type: object
              properties:
                code:
                  type: string
                  example: '001'
                branch:
                  type: string
                  example: '004'
                branch_digit:
                  type:
                    - string
                    - 'null'
                  example: '123'
                account:
                  type: string
                  example: '1234567890'
                account_digit:
                  type:
                    - string
                    - 'null'
                  example: '123'
                account_type:
                  type: string
                  example: SAVINGS
                routing:
                  type: string
                  example: '021000021'
                country:
                  type: string
                  example: CO
                currency:
                  type: string
                  example: COP
        documentation:
          type: array
          items:
            type: object
            properties:
              file_name:
                type: string
                example: cc-front.pdf
              content_type:
                type: string
                example: application/pdf
              content_category:
                type: string
                example: IDENTIFICATION
              content:
                type: string
                example: JVBERi0xLjQKJ...
        onboardings:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                example: 84c42684-dbe5-4e0f-bd17-4d094e19762d
              type:
                type: string
                example: ONBOARD_ONTO_THE_PROVIDER
              workflow:
                type: string
                example: DIRECT
              status:
                type: string
                example: PENDING
              callback_url:
                type: string
                example: https://merchant.example.com/webhook/onboarding
              provider:
                type: object
                properties:
                  id:
                    type: string
                    example: ALELO
                  connection_id:
                    type: string
                    example: cc389b51-53a1-4a29-af40-c8cee26c3399
                  recipient_id:
                    type:
                      - string
                      - 'null'
                    example: null
                  redirect_url:
                    type:
                      - string
                      - 'null'
                    example: null
                  onboarding_url:
                    type:
                      - string
                      - 'null'
                    example: null
                  legal_entity:
                    type:
                      - string
                      - 'null'
                    example: null
                  balance_account_id:
                    type:
                      - string
                      - 'null'
                    example: null
                  legal_entity_id:
                    type:
                      - string
                      - 'null'
                    example: null
              documentation:
                type: array
                items:
                  type: object
                  properties:
                    file_name:
                      type: string
                      example: utility-bill.pdf
                    content_type:
                      type: string
                      example: application/pdf
                    content_category:
                      type: string
                      example: ADDRESS_PROOF
                    content:
                      type: string
                      example: JVBERi0xLjQKJ...
              legal_representatives:
                type: array
                items:
                  type: object
                example: []
              requirements:
                type: array
                items:
                  type: object
                  properties:
                    field:
                      type: string
                      example: document.cc
                    message:
                      type: string
                      example: Provide CC document image
                    status:
                      type: string
                      example: PENDING
              withdrawal_methods:
                type: object
                properties:
                  bank:
                    type: object
                    properties:
                      code:
                        type: string
                        example: '002'
                      branch:
                        type: string
                        example: '002'
                      branch_digit:
                        type:
                          - string
                          - 'null'
                        example: null
                      account:
                        type: string
                        example: '9876543210'
                      account_digit:
                        type:
                          - string
                          - 'null'
                        example: null
                      account_type:
                        type: string
                        example: SAVINGS
                      routing:
                        type: string
                        example: '021000022'
                      country:
                        type: string
                        example: CO
                      currency:
                        type: string
                        example: COP
              terms_of_service:
                type: object
                properties:
                  acceptance:
                    type: boolean
                    example: true
                  date:
                    type: string
                    example: '2025-07-21T20:43:54Z'
                  ip:
                    type: string
                    example: 129.21.111.11
              created_at:
                type: string
                format: date-time
                example: '2025-08-27T15:41:19.516982Z'
              updated_at:
                type: string
                format: date-time
                example: '2025-08-27T15:41:19.516989Z'
        split_configuration:
          type: object
          description: >-
            Reglas para el cálculo automático de la división a nivel de
            destinatario.
          properties:
            calculation_type:
              type: string
              description: El método que se usa para calcular el monto del split.
              enum:
                - PERCENTAGE
                - FIXED
                - MIXED
              example: PERCENTAGE
            percentage:
              type: number
              description: >-
                Porcentaje del monto total del pago que se va a dividir
                (0.01-100.00). Obligatorio si calculation_type es PERCENTAGE o
                MIXED.
              minimum: 0.01
              maximum: 100
              example: 10.5
            fixed_amount:
              type: number
              description: >-
                Monto fijo que se va a dividir. Obligatorio si calculation_type
                es FIXED o MIXED.
              minimum: 0.0001
              example: 5
            currency:
              type: string
              description: >-
                Código de moneda ISO 4217. Obligatorio para todos los tipos de
                cálculo.
              example: USD
            rounding_mode:
              type: string
              description: >-
                La estrategia de redondeo para los montos calculados.
                Obligatorio para PERCENTAGE y MIXED.
              enum:
                - STANDARD
                - ROUND_UP
                - ROUND_DOWN
              example: STANDARD
        created_at:
          type: string
          format: date-time
          description: Fecha de creación del destinatario (ISO 8601 MAX 27; MIN 27).
          example: '2025-08-27T15:41:19.497413Z'
        updated_at:
          type: string
          format: date-time
          description: >-
            Fecha de la última actualización del destinatario (ISO 8601 MAX 27;
            MIN 27).
          example: '2025-08-27T15:41:19.497425Z'
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          example: INVALID_PARAMETERS
        messages:
          type: array
          items:
            type: string
            example: Invalid request
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.