> ## Documentation Index > Fetch the complete documentation index at: https://docs.ebury.com/llms.txt > Use this file to discover all available pages before exploring further. # Accept a multi payment Accepts the trades generated during the multi payment initiation and also books the associated payments. ## OpenAPI ````yaml /openapi.json patch /multipayments/{multipayment_id} openapi: 3.0.0 info: description: | Ebury API allows customers: to retrieve accounts, balances, beneficiaries, and transactions; to get buy/sell estimates and quotes, book trades and retrieve trade history; to allocate payments to a trade and beneficiary, and to submit payments in bulk; to download documents such as trade receipt, payment instruction and payment receipt; to manage the authorised persons on their account. The Metadata API allows applications to clarify some parts of the Ebury API that are impractical to express schematically. termsOfService: https://docs.ebury.io/#terms-of-use title: Ebury API version: '0.1' servers: - url: https://{environment}.ebury.io variables: environment: default: api enum: - api - sandbox security: - api_key: [] paths: /multipayments/{multipayment_id}: patch: tags: - Multi Payments summary: Accept a multi payment description: Accept a multi payment generated trade and book in payments parameters: - description: The multi payment ID in: path name: multipayment_id required: true schema: type: string - description: The ID of the client in: query name: client_id required: true schema: type: string - name: Authorization in: header description: The access token required: true schema: type: string - description: The ID of the contact in: header name: X-Contact-ID required: false schema: type: string responses: '200': description: >- Multi payment accepted and payments booked (pending back office operations) content: application/json: schema: $ref: '#/components/schemas/BankAccount' '400': description: >- Formatting or schema validation error. See error message for further details content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '401': description: Access denied due to authentication failure '403': description: >- Could not complete action due to data constraints. Refer to error message for additional details content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '404': description: Multi payment or client ID not found '409': description: Multi payment already accepted or rejected '502': description: Internal integration error. Contact support content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' components: schemas: BankAccount: allOf: - $ref: '#/components/schemas/BankAccountCoreData' description: A bank account. properties: account_id: description: The identifier of the bank account. type: integer required: - account_id type: object ErrorMessage: description: An error message. properties: code: type: string description: The code for the error. details: description: Error details type: string message: type: string description: A short description of the cause of the error. required: - code - message - details type: object BankAccountCoreData: description: >- The data of the bank account. Refer to the Metadata API for valid field combinations. properties: account_number: description: The account number of the bank account. type: string bank_address_line_1: description: The first address line of the bank. type: string bank_country_code: description: The ISO 3166-1 alpha-2 code of the bank's country. pattern: '[A-Z]{2}' type: string bank_currency_code: description: The ISO 4217 code of the bank account's currency. pattern: '[A-Z]{3}' type: string bank_identifier: description: The identifier of the bank. type: string bank_name: description: Name of the bank account holder. type: string correspondent_account: description: The account for the correspondant account of the bank. type: string correspondent_swift_code: description: The SWIFT code for the correspondant account of the bank. type: string iban: description: The IBAN of the bank account. type: string inn: description: The INN of the bank account. type: string kbk: description: The KBK of the bank account. type: string kio: description: The KIO of the bank account. type: string kpp: description: The KPP of the bank account. type: string purpose_of_payment: description: >- Text explaining the purpose of payment. Required by the Central Bank for all payments sent to China (CHN) in the Chinese Renminbi (CNY) currency or United Arab Emirates in any currency (GDE to RDA) [Coming soon]. enum: - /CGODDR/ - /CGODDR/PART/ - /CGODDR/RETN/ - /CSTRDR/ - /CSTRDR/PART/ - /CSTRDR/RETN/ - /COCADR/ - /COCADR/RTN/ - /CCTFDR/ - /CCTFDR/PART/ - /CCTFDR/RETN/ - /CCDNDR/ - /CCDNDR/RTN/ - GDE - GDI - GMS - STS - ATS - OTS - STR - SCO - INS - FIS - IPC - TCS - ITS - IFS - RDS - PMS - TTS - PRS - GOS - SAL - IGD - IID - PIP - PRR - DOE - ISH - ISL - ISS - IOL - IOD - GRI - CHC - EDU - ALW - AES - LAS - OVT - TKT - SAA - COP - COM - EOS - BON - PEN - UTL - DCP - LND - LIP - IPO - POR - RNT - LNC - EMI - DIV - ACM - CCP - POS - MCR - CIN - TOF - IGT - OAT - SVI - SVO - SVP - MWI - MWO - MWP - PRP - PRW - IRP - IRW - CEA - PPA - DSF - DLF - FSA - FIA - DSA - DLA - FDA - AFA - SLA - LLA - LEA - RFS - TCR - CEL - PPL - LDS - LDL - FSL - FIL - DSL - DLL - FDL - AFL - SLL - LLL - LEL - RLS - TCP - TAX - REL - RDL - REA - RDA type: string reason_for_trade: description: The reason for trade of the bank account. type: string reference_information: description: The reference information of the bank account. type: string russian_central_bank_account: description: The Russian central account number of the bank account. type: string swift_code: description: The SWIFT code of the bank account. type: string vo: description: The VO of the bank account. type: string required: - bank_country_code - bank_currency_code type: object securitySchemes: api_key: description: An API Key. in: header name: x-api-key type: apiKey ````