openapi: 3.1.0
info:
  license:
    name: Instant Payments API
    url: https://khipu.com
  title: Instant Payment API
  description: Fully RESTful payment API.
  version: v2.0
servers:
  - url: https://khipu.com/api
    description: Production
security:
  - khipu: []
paths:
  /2.0/banks:
    get:
      operationId: getBanks
      summary: Get banks
      description: >-
        This method obtains the list of banks that can be used to pay in this
        collection account.
      parameters: []
      responses:
        '200':
          description: >-
            Successful operation. Returns a JSON object with the array of
            available banks.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bank-get-banks'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
  /2.0/payments/{id}/confirm:
    post:
      operationId: postPaymentConfirmById
      summary: Confirm payment by Id
      description: >
        **Warning: This feature is only available to customers who have
        contracted it independently.

        To use it, please contact us at soporte@khipu.com**<br><br>

        Confirm payment. Upon confirming payment, the funds will be delivered to
        the merchant the next business day.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            maxLength: 255
          description: Payment identifier
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
  /2.0/payments/{id}:
    get:
      operationId: getPaymentById
      summary: Get payment by Id
      description: >-
        This method obtains the complete payment information. Includes the
        current status of the payment.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            maxLength: 255
          description: Payment identifier
      responses:
        '200':
          description: >-
            Successful operation. Returns a JSON object with the payment
            information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payment-get-payment'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
    delete:
      operationId: deletePaymentById
      summary: Delete payment by Id
      description: Delete a payment. Only applicable to payments with status `pending`.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            maxLength: 255
          description: Payment identifier
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
  /2.0/payments:
    get:
      operationId: postPaymentByToken
      summary: Get payment by notification token
      description: >-
        Complete payment information. Data with which it was created and the
        current status of the payment. It is obtained from the
        notification_token that Khipu sends on conciliation.
      parameters:
        - in: query
          name: notification_token
          description: Notification token from the notification API 1.3.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            Successful operation. Returns a JSON object with the information of
            the payment
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payment-get-payment'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
    post:
      operationId: postPayment
      summary: Create payment
      description: >-
        Create a payment in Khipu and obtain the URLs to redirect the user to
        complete the payment.
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/payment-post-payment'
      responses:
        '200':
          description: >-
            Successful operation. Returns a JSON object with the information of
            the payment created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payment-post-payment-2'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
  /2.0/payments/{id}/refunds:
    post:
      operationId: postPaymentRefundsById
      summary: Refund payment by Id
      description: >-
        Refunds all or part of the amount of a payment. This operation can only
        be carried out in businesses that collect in a Khipu account and before
        the corresponding funds are delivered.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            maxLength: 255
          description: Payment identifier
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/payment-post-payment-refunds'
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
  /2.0/receivers:
    post:
      operationId: postReceiver
      summary: Post receiver
      description: >
        **Warning: This feature is only available to customers who have
        contracted it independently.

        To use it, please contact us at soporte@khipu.com**<br><br>

        Create a new collection account associated with an integrator.
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/receiver-post-receiver'
      responses:
        '200':
          description: >-
            Successful operation. Returns a JSON object with the identifier and
            secret of the new collection account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/receiver-post-receiver-2'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
  /2.0/merchants/{id}/paymentMethods:
    get:
      operationId: getMerchantPaymentMethodsById
      summary: Get payment methods
      description: Lists available payment methods for a given collection account.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: number
          description: Collection account identifier
      responses:
        '200':
          description: >-
            Successful operation. Returns a JSON object with the array of
            available payment methods.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/merchant-get-payment-methods'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid or missing credentials
        '403':
          description: Forbidden
        '404':
          description: Not found - Resource not available
        '500':
          description: Internal server error
components:
  securitySchemes:
    Api-Key:
      type: apiKey
      in: header
      name: x-api-key
  schemas:
    bank-get-banks:
      type: object
      required:
        - banks
      properties:
        banks:
          type: array
          minItems: 1
          description: Array with list of banks.
          items:
            type: object
            description: Bank details.
            required:
              - bank_id
              - name
              - message
              - min_amount
              - type
              - parent
            properties:
              bank_id:
                type: string
                description: Bank identifier.
                example: SDdGj
              name:
                type: string
                description: Name of the bank.
                example: Banco Estado
              message:
                type: string
                description: Message with bank details.
                example: >-
                  Tarifa de $300 de transferencia a otros bancos, usando
                  CuentaRUT.
              min_amount:
                type: number
                format: double
                description: Minimum amount that the bank accepts in a payment.
                example: 1000
              type:
                type: string
                enum:
                  - Persona
                  - Empresa
                description: Bank type.
                example: Persona
              parent:
                type: string
                description: >-
                  Identifier of the parent bank (if a bank has personal and
                  business banking, the first will be the parent of the second).
                example: ''
              logo_url:
                type: string
                description: URL of the bank's logo.
                example: >-
                  https://s3.amazonaws.com/static.khipu.com/logos/bancos/chile/estado-icon.png
    success:
      type: object
      description: Object for successful API responses.
      required:
        - message
      properties:
        message:
          type: string
          description: Message to be displayed to the user.
          example: Message.
    payment-get-payment:
      type: object
      description: >-
        Complete payment information. Includes the current status of the
        payment.
      required:
        - amount
        - app_url
        - attachment_urls
        - bank
        - bank_account_number
        - bank_id
        - body
        - cancel_url
        - currency
        - custom
        - discount
        - expires_date
        - funds_source
        - notification_token
        - notify_api_version
        - notify_url
        - out_of_date_conciliation
        - payer_email
        - payer_name
        - payment_id
        - payment_method
        - payment_url
        - personal_identifier
        - picture_url
        - ready_for_terminal
        - receipt_url
        - receiver_id
        - responsible_user_email
        - return_url
        - send_email
        - send_reminders
        - simplified_transfer_url
        - status
        - status_detail
        - subject
        - third_party_authorization_details
        - transaction_id
        - transfer_url
      properties:
        payment_id:
          type: string
          description: >-
            Unique identifier of the payment, it is a 12-character alphanumeric
            string. Because this identifier is unique, it can be used, for
            example, to avoid processing a repeated notification. (Khipu waits
            for a code 200 when notifying a payment, if this does not occur it
            retries for up to two days).
          example: gqzdy6chjne9
        payment_url:
          type: string
          description: >-
            Main payment URL, if the user has not previously chosen a payment
            method, the options are shown.
          example: https://khipu.com/payment/info/gqzdy6chjne9
        simplified_transfer_url:
          type: string
          description: Simplified payment URL.
          example: https://app.khipu.com/payment/simplified/gqzdy6chjne9
        transfer_url:
          type: string
          description: Normal payment URL.
          example: https://khipu.com/payment/manual/gqzdy6chjne9
        app_url:
          type: string
          description: URL to invoke payment from a mobile device using the Khipu APP.
          example: khipu:///pos/gqzdy6chjne9
        ready_for_terminal:
          type: boolean
          description: >-
            It is `true` if the payment already has all the necessary data to
            directly open the Khipu payment application.
          example: false
        notification_token:
          type: string
          description: >-
            String of alphanumeric characters that uniquely identify the
            payment, it is the identifier that the Khipu server will send to the
            merchant server when notifying that a payment is reconciled.
          example: 9dec8aa176c5223026919b3b5579a4776923e646ff3be686b9e6b62ec042e91f
        receiver_id:
          type: integer
          format: int64
          description: Unique identifier of a collection account.
          example: 985101
        conciliation_date:
          type: string
          format: date-time
          description: Date and time of payment reconciliation. ISO-8601 format.
          example: '2017-03-01T13:00:00Z'
        subject:
          type: string
          description: Text to summarize the charge.
          example: Test
        amount:
          type: number
          format: double
          description: The amount of the charge.
          example: 1000
        currency:
          type: string
          description: The currency code in ISO-4217 format.
          example: CLP
        status:
          type: string
          enum:
            - pending
            - verifying
            - done
          description: >-
            Payment status, it can be `pending` (the payer has not yet started
            paying), `verifying` (the payment is being verified) or `done`, when
            the payment is already confirmed.
          example: done
        status_detail:
          type: string
          enum:
            - pending
            - normal
            - marked-paid-by-receiver
            - rejected-by-payer
            - marked-as-abuse
            - reversed
          description: >-
            Detail of the payment status:

            `pending` (the payer has not yet started paying),

            `normal` (the payment was verified and was canceled by some standard
            payment method),

            `marked-paid-by-receiver` (the merchant marked the charge as paid),

            `rejected-by-payer` (the payer declared that they will not pay),

            `marked-as-abuse` (the payer declared that they will not pay and
            that the charge was unsolicited), and

            `reversed` (the payment was canceled by the merchant, the money was
            returned to the payer).
          example: normal
        body:
          type: string
          description: Payment details.
          example: Test
        picture_url:
          type: string
          description: URL with image of the payment.
          example: https://micomercio.com/picture_url
        receipt_url:
          type: string
          description: URL of the payment receipt.
          example: https://micomercio.com/order/receipt_url
        return_url:
          type: string
          description: URL where the payer is redirected after the payment is completed.
          example: https://micomercio.com/order/return_url
        cancel_url:
          type: string
          description: >-
            URL where the payer is redirected after they give up making the
            payment.
          example: https://micomercio.com/order/cancel_url
        notify_url:
          type: string
          description: URL of the webservice where the payment will be notified.
          example: https://micomercio.com/webhook/notify_url
        notify_api_version:
          type: string
          description: Notification API version.
          example: '3.0'
        expires_date:
          type: string
          format: date-time
          description: >-
            Maximum date to execute the payment (in ISO-8601 format). The client
            may make several payment attempts until said date. Each attempt has
            an individual period of 3 hours for its execution.
          example: '2023-12-31T15:45:00-04:00'
        attachment_urls:
          type: array
          minItems: 0
          description: Array of URLs of files attached to the payment.
          items:
            type: string
            description: File URL attached to payment.
            example: https://micomercio.com/attachment1.pdf
        bank:
          type: string
          description: Name of the bank selected by the payer.
          example: Banco de Chile (Edwards Citi)
        bank_id:
          type: string
          description: Identifier of the bank selected by the payer.
          example: dfFbF
        payer_name:
          type: string
          description: Payer's name.
          example: Nombre Pagador
        payer_email:
          type: string
          format: email
          description: Payer email.
          example: pagador@email.com
        personal_identifier:
          type: string
          description: Personal identifier of the payer.
          example: 11.000.111-9
        bank_account_number:
          type: string
          description: Payer's bank account number.
          example: '001120490689'
        out_of_date_conciliation:
          type: boolean
          description: >-
            It is `true` if the payment reconciliation was made after the
            expiration date.
          example: true
        transaction_id:
          type: string
          description: Payment identifier assigned by the merchant.
          example: zwo3wqz6uulcvajt
        custom:
          type: string
          description: >-
            Generic field assigned by the merchant at the time of making the
            payment.
          example: <xml>...</xml>
        responsible_user_email:
          type: string
          description: Email of the person responsible for the payment.
          example: responsible@email.com
        send_reminders:
          type: boolean
          description: >-
            It is `true` when this is an email collection and Khipu will send
            reminders.
          example: true
        send_email:
          type: boolean
          description: It is `true` when Khipu will send the payment by email.
          example: true
        payment_method:
          type: string
          enum:
            - regular_transfer
            - simplified_transfer
            - not_available
          description: >-
            Payment method used by the payer, it can be `regular_transfer` or
            `simplified_transfer`.
          example: simplified_transfer
        funds_source:
          type: string
          enum:
            - debit
            - prepaid
            - credit
            - ''
            - not-available
          description: >-
            Source of funds used by the payer, it can be `debit` for payment
            with debit, `prepaid` for payment with prepaid, `credit` for payment
            with credit, or empty in case it has been paid by bank transfer.
          example: debit
        discount:
          type: number
          format: double
          description: Amount to be deducted from the value paid.
          example: 0
        third_party_authorization_details:
          type: string
          description: Disregard this field.
          example: ''
    payment-post-payment:
      type: object
      description: >-
        Create a payment in Khipu and obtain the URLs to redirect the user to
        complete the payment.
      required:
        - amount
        - currency
        - subject
      properties:
        amount:
          type: number
          format: double
          description: >-
            The amount of the charge. Without thousands separator and using '.'
            as decimal separator. Up to 4 decimal places, depending on currency.
          example: 1000
        currency:
          type: string
          maxLength: 255
          enum:
            - CLP
            - ARS
            - PEN
            - MXN
            - USD
            - EUR
            - BOB
            - COP
          description: >-
            The currency code in ISO-4217 format. The currencies available for
            payment will depend on the country configured for the merchant.
          example: CLP
        subject:
          type: string
          maxLength: 255
          description: Text to summarize the charge.
          example: Cobro de prueba
        transaction_id:
          type: string
          maxLength: 255
          description: 'Transaction''s identifier. Ex: invoice or purchase order number.'
          example: zwo3wqz6uulcvajt
        custom:
          type: string
          maxLength: 1073741824
          description: >-
            Parameter to send personalized transaction information. Ex: XML
            document with the shopping cart details.
          example: <xml>...</xml>
        body:
          type: string
          maxLength: 5120
          description: Description of the charge.
          example: 'Cobro de orden de compra #123-abcdef'
        bank_id:
          type: string
          maxLength: 5
          description: Bank identifier to use in the payment.
          example: SDdGj
        return_url:
          type: string
          maxLength: 1024
          description: The URL to send the customer to while the payment is being verified.
          example: https://micomercio.com/order/return_url
        cancel_url:
          type: string
          maxLength: 1024
          description: >-
            The URL to send the customer to if they decide not to make the
            transaction.
          example: https://micomercio.com/order/cancel_url
        picture_url:
          type: string
          maxLength: 1024
          description: A URL of a photo of your product or service.
          example: https://micomercio.com/picture_url
        notify_url:
          type: string
          maxLength: 1024
          description: >-
            The address of the web-service that khipu will use to notify when
            the payment is reconciled.
          example: https://micomercio.com/webhook/notify_url
        contract_url:
          type: string
          maxLength: 1024
          description: >-
            The URL address of the PDF file with the contract to be signed
            through this payment. The merchant must be enabled for this service
            and the `fixed_payer_personal_identifier` field is required.
          example: https://micomercio.com/contract_url
        notify_api_version:
          type: string
          maxLength: 255
          description: >-
            Version of the notifications API to receive notifications by
            web-service.
          example: '3.0'
        expires_date:
          type: string
          format: date-time
          description: >-
            Maximum date to execute the payment (in ISO-8601 format). The client
            may make several payment attempts until said date. Each attempt has
            an individual period of 3 hours for its execution.
          example: '2023-12-31T15:45:00-04:00'
        send_email:
          type: boolean
          description: >-
            If `true`, a collection request will be sent to the email specified
            in `payer_email`.
          example: false
        payer_name:
          type: string
          maxLength: 255
          description: Payer's name. It is required when `send_email` is `true`.
          example: Nombre Pagador
        payer_email:
          type: string
          maxLength: 255
          format: email
          description: Payer's email. Required when `send_email` is `true`.
          example: pagador@email.com
        send_reminders:
          type: boolean
          description: If `true`, collection reminders will be sent.
          example: true
        responsible_user_email:
          type: string
          maxLength: 255
          format: email
          description: >-
            Email of the person responsible for this collection, must correspond
            to a khipu user with permissions to collect using this collection
            account.
          example: responsible@email.com
        fixed_payer_personal_identifier:
          type: string
          maxLength: 255
          description: >-
            Personal identifier. If specified, payment can only be made using
            that identifier.
          example: 11.000.111-9
        integrator_fee:
          type: string
          maxLength: 16
          description: >-
            Fee for the integrator. It is only valid if the collection account
            has an associated integrator account.
          example: '100'
        collect_account_uuid:
          type: string
          maxLength: 255
          description: >-
            For collection accounts with more own account. Allows you to choose
            the account where the transfer should occur.
          example: '007367340234'
        confirm_timeout_date:
          type: string
          format: date-time
          description: >-
            Collection submission date. It is also the final date to be able to
            refund the charge. ISO-8601 format.
          example: '2017-03-01T13:00:00Z'
        mandatory_payment_method:
          type: string
          maxLength: 255
          description: >-
            The charge can only be paid using the specified payment method.
            Possible values for this field are found in the `id` field of the
            response from the `/api/3.0/merchants/paymentMethods` endpoint.
          example: simplified_transfer
        psp_client_merchant_name:
          type: string
          minLength: 3
          maxLength: 255
          description: >-
            Name of the end merchant for whom a Payment Service Provider is
            processing a payment. Required for PSP client transactions; not
            applicable for others.
          example: Client Name
    payment-post-payment-2:
      type: object
      description: >-
        Create a payment in Khipu and obtain the URLs to redirect the user to
        complete the payment.
      required:
        - payment_id
        - payment_url
        - simplified_transfer_url
        - transfer_url
        - app_url
        - ready_for_terminal
      properties:
        payment_id:
          type: string
          description: >-
            Unique identifier of the payment, it is a 12-character alphanumeric
            string. Because this identifier is unique, it can be used, for
            example, to avoid processing a repeated notification. (Khipu waits
            for a code 200 when notifying a payment, if this does not occur it
            retries for up to two days).
          example: gqzdy6chjne9
        payment_url:
          type: string
          description: >-
            Main payment URL, if the user has not previously chosen a payment
            method, the options are shown.
          example: https://khipu.com/payment/info/gqzdy6chjne9
        simplified_transfer_url:
          type: string
          description: Simplified payment URL.
          example: https://app.khipu.com/payment/simplified/gqzdy6chjne9
        transfer_url:
          type: string
          description: Normal payment URL.
          example: https://khipu.com/payment/manual/gqzdy6chjne9
        app_url:
          type: string
          description: URL to invoke payment from a mobile device using the Khipu APP.
          example: khipu:///pos/gqzdy6chjne9
        ready_for_terminal:
          type: boolean
          description: >-
            It is `true` if the payment already has all the necessary data to
            directly open the Khipu payment application.
          example: false
    payment-post-payment-refunds:
      type: object
      description: >-
        Refunds all or part of the amount of a payment. This operation can only
        be carried out in businesses that collect in a Khipu account and before
        the corresponding funds are delivered.
      properties:
        amount:
          type: number
          format: double
          description: >-
            The amount to be returned. Without thousands separator and using '.'
            as a decimal separator. Up to 4 decimal places, depending on
            currency. If it is omitted, the refund will be made for the total
            payment amount.
          example: 1000
    receiver-post-receiver:
      type: object
      description: >-
        Create a new collection account associated with an integrator. You need
        associated user account details, billing details and contact details.
      required:
        - admin_first_name
        - admin_last_name
        - admin_email
        - country_code
        - business_identifier
        - business_category
        - business_name
        - business_phone
        - business_address_line_1
        - business_address_line_2
        - business_address_line_3
        - contact_full_name
        - contact_job_title
        - contact_email
        - contact_phone
      properties:
        admin_first_name:
          type: string
          maxLength: 255
          description: >-
            First name of the administrator of the collection account to be
            created.
          example: Nombre
        admin_last_name:
          type: string
          maxLength: 255
          description: >-
            Last name of the administrator of the collection account to be
            created.
          example: Apellido
        admin_email:
          type: string
          maxLength: 255
          format: email
          description: Email of the administrator of the collection account to be created.
          example: admin@email.com
        country_code:
          type: string
          maxLength: 2
          description: >-
            ISO 3166-1 two-character alphanumeric code of the country of the
            collection account to be created.
          example: CL
        business_identifier:
          type: string
          minLength: 8
          maxLength: 255
          description: >-
            Tax identifier of the merchant associated with the collection
            account to be created.
          example: 99.999.999-9
        business_category:
          type: string
          maxLength: 255
          description: >-
            Tax category or tax item of the merchant associated with the
            collection account to be created.
          example: VENTA AL POR MAYOR DE FRUTAS Y VERDURAS
        business_name:
          type: string
          maxLength: 255
          description: >-
            Tax name of the merchant associated with the collection account to
            be created.
          example: Nombre Tributario
        business_phone:
          type: string
          minLength: 5
          maxLength: 20
          description: >-
            Telephone of the merchant associated with the collection account to
            be created.
          example: '+56988887777'
        business_address_line_1:
          type: string
          minLength: 4
          maxLength: 300
          description: Address of the merchant of the collection account to be created.
          example: Calle principal 1111
        business_address_line_2:
          type: string
          minLength: 4
          maxLength: 300
          description: >-
            Second line of the address of the merchant of the collection account
            to be created.
          example: Oficina 3-A
        business_address_line_3:
          type: string
          minLength: 4
          maxLength: 300
          description: >-
            Third line of the address of the merchant of the collection account
            to be created.
          example: Santiago
        contact_full_name:
          type: string
          maxLength: 255
          description: Name of the merchant's contact.
          example: Nombre Contacto
        contact_job_title:
          type: string
          maxLength: 255
          description: Position of the merchant contact.
          example: Tesorero
        contact_email:
          type: string
          maxLength: 255
          format: email
          description: Email address of the merchant's contact.
          example: contacto@email.com
        contact_phone:
          type: string
          minLength: 5
          maxLength: 20
          description: Merchant's contact phone number.
          example: '+56955553333'
        bank_account_bank_id:
          type: string
          maxLength: 5
          description: Bank identifier.
          example: SDdGj
        bank_account_type:
          type: string
          maxLength: 255
          description: >-
            Account type. It is required if the alternative trusted integrator
            model is used.
          example: Cuenta Corriente
        bank_account_identifier:
          type: string
          maxLength: 50
          description: Personal identifier of the owner of the bank account.
          example: 11.333.555-7
        bank_account_name:
          type: string
          maxLength: 255
          description: Bank account name.
          example: Alias Cuenta
        bank_account_number:
          type: string
          maxLength: 255
          description: Bank account number.
          example: '00347909823'
        notify_url:
          type: string
          maxLength: 1024
          description: Default URL for the webservice where the payment will be notified.
          example: http://micomercio.com/account/notify_url
        rendition_url:
          type: string
          maxLength: 1024
          description: URL for the webservice where the accountability will be notified.
          example: http://micomercio.com/account/rendition_url
    receiver-post-receiver-2:
      type: object
      description: Object for collection account creation response.
      required:
        - receiver_id
        - secret
      properties:
        receiver_id:
          type: string
          description: Unique identifier of the collection account.
          example: '934568'
        secret:
          type: string
          description: Secret key to the collection account, used to sign all requests.
          example: b2025dc47a29a04592fa3c1191110370db0e208c
    merchant-get-payment-methods:
      type: object
      required:
        - paymentMethods
      properties:
        paymentMethods:
          type: array
          minItems: 1
          description: Array with available payment methods.
          items:
            type: object
            description: Payment method.
            required:
              - id
              - name
              - logo_url
            properties:
              id:
                type: string
                description: Payment method identifier.
                example: simplified_transfer
              name:
                type: string
                description: Name of the payment method.
                example: simplified_transfer
              logo_url:
                type: string
                description: URL of the suggested logo to display.
                example: >-
                  https://s3.amazonaws.com/static.khipu.com/buttons/2015/150x50-transparent.png
