openapi: 3.2.0 info: title: WorldLink v2 API description: 'WorldLink is a complete cross-border payment and Foreign-Exchange (FX) service that allows you to perform payments in 135 currencies without having the need to maintain local currency accounts for each of them.' contact: name: Standards & Developer Hub url: https://tts.sandbox.developer.citi.com/citiconnect/ email: developer-support@citi.com version: 2.0.0 servers: - url: https://tts.apib2b.citi.com/citiconnect/prod/worldlinkservices description: production gateway url - url: https://tts.sandbox.apib2b.citi.com/citiconnect/sb/worldlinkservices description: sandbox url security: - clientCredentials: [] tags: - name: WorldLink v2 paths: /v2/doddfrank/disclosure: post: tags: - WorldLink v2 summary: WorldLink Dodd Frank description: 'CitiConnect WorldLink Dodd Frank allows users to access information for fees, taxes, and delivery dates. This information is subsequently provided to consumers on a Dodd Frank 1073 disclosure or receipt.' operationId: doddFrankRequestUsingPOST parameters: - name: client_id in: query description: Unique identifier which is created during the onboarding process. required: true schema: type: string - name: Content-Type in: header description: Supports \"application/xml\" and \"application/json\". required: true schema: type: string - name: Authorization in: header description: The OAuth Token prefixed with "Bearer" and space in between. required: true schema: type: string requestBody: description: Request body for WorldLink Dodd Frank content: application/json: schema: $ref: '#/components/schemas/disclosure_request' example: in: clientId: '24884' subEntityId: '0001' destinationCountry: IN destinationState: AK destinationCity: ANCHORAGE bankCode: CITIIN00 bankCodeType: B paymentMethod: W paymentCurrency: INR fundingCurrency: USD paymentCurrencyAmount: 100 nonSTPFlag: N isBeneDeduct: Y citiPointOfOrigination: US beneDeductFeeType: T estimatePercentile: 95 chargeCode: SHA releaseTime: '2026-04-23T16:11:23.000' nostroCountry: AU flagODE: N valueDate: '2026-04-23' flagFutureDated: N required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/disclosure_response' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/Error-Message' example: correlationId: q2te~bd8e9b8f-d8e5-4a48-ad13-5d1ec8bb32e815587 message: Mismatch of WorldLink client ID or client ID is not maintained. status: '400' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Unauthorized httpCode: '401' moreInformation: This server could not verify that you are authorized to access the URL '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Not Found httpCode: '404' moreInformation: No resources match requested URI '405': description: Method Not Allowed content: application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Method Not Allowed httpCode: '405' moreInformation: The method is not allowed for the requested URL '415': description: Unsupported Media Type content: application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Unsupported Media Type httpCode: '415' moreInformation: Unsupported Content-Type '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/Error-Message' example: message: Unable to process your request status: '500' correlationId: q2te~8b8b4912-1b37-449a-9e1a-3401d7ab7d8312352 x-codegen-request-body-name: body /v2/payment/inquiry: post: tags: - WorldLink v2 summary: WorldLink Payment Status Inquiry description: CitiConnect WorldLink Payment Status Inquiry allows users to receive information about payments initiated and intermediate processing statuses in real time until the payment is complete. operationId: PaymentStatusInquiries parameters: - name: client_id in: query description: unique identifier which created during onboarding process required: true schema: type: string - name: Content-Type in: header description: Supports \"application/xml\" and \"application/json\". required: true schema: type: string - name: Authorization in: header description: The OAuth Token prefixed with "Bearer" and space in between. required: true schema: type: string requestBody: description: Request Body content: application/xml: schema: $ref: '#/components/schemas/PaymentInquiryRequest' example: WL2020010701583700001 application/json: schema: $ref: '#/components/schemas/PaymentInquiryRequest' example: EndToEndId: WL2020010701 WLClientID: '583700001' required: true responses: '200': description: OK content: application/xml: schema: $ref: '#/components/schemas/paymentStatusInquiryResponse' example: 2132769616722026-01-13T06:44:05ZBNP SECURITIES SERVICES PRIVATE LIMITED24884Not AvailableNot AvailableNot Applicable20JULMPY_0645A20JULMPY_0645AACCP0.02CitiBank2021-07-27T00:00:00ZKL6KFI2UTDVM99.981002021-07-272021-07-27MPAYPAYMENT 1 PAYMENT 2 PAYMENT 30OFXR1.18830RMETB0FXDT2021-07-23 00:00:00.00FAWF118.830OFXNI020400BTB1/ACC/STEP20FAMT118.830FCCYUSD0WLID24884000111738569CITIFIHXXXXRoger Federer20JULMPY_0645AFI4571308501080486 application/json: schema: $ref: '#/components/schemas/paymentStatusInquiryResponse' examples: Payment-Status-Inquiry-Response-Json: $ref: '#/components/examples/Payment-Status-Inquiry-Response-Json' '400': description: Bad Request content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 400Mismatch of WorldLink Client ID or Client ID not maintainedq2te~8b8b4912-1b37-449a-9e1a-3401d7ab7d8312198 application/json: schema: $ref: '#/components/schemas/Error-Message' example: correlationId: q2te~bd8e9b8f-d8e5-4a48-ad13-5d1ec8bb32e815587 message: Mismatch of WorldLink client ID or client ID is not maintained. status: '400' '401': description: Unauthorized content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 401Invalid OAuth TokenPlease use valid OAuth Token application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Unauthorized httpCode: '401' moreInformation: This server could not verify that you are authorized to access the URL '404': description: Not found content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 404Not FoundNo resources match requested URI application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Not Found httpCode: '404' moreInformation: No resources match requested URI '405': description: Method Not Allowed content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 405Method Not AllowedThe method is not allowed for the requested URL application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Method Not Allowed httpCode: '405' moreInformation: The method is not allowed for the requested URL '415': description: Unsupported Media Type content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 415Unsupported Media TypeUnsupported Content-Type application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Unsupported Media Type httpCode: '415' moreInformation: Unsupported Content-Type '500': description: Internal Server Error content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 500Unable to process your requestq2te~8b8b4912-1b37-449a-9e1a-3401d7ab7d8312352 application/json: schema: $ref: '#/components/schemas/Error-Message' example: message: Unable to process your request status: '500' correlationId: q2te~8b8b4912-1b37-449a-9e1a-3401d7ab7d8312352 x-codegen-request-body-name: payment_status_inquiries /v2/payment/validation: post: tags: - WorldLink v2 summary: WorldLink Payment Upfront Validation description: 'CitiConnect WorldLink Payment Upfront Validation allows you to know upfront, the payment rules required to make payments within a certain country or currency to avoid transaction rejection post submission. This feature will provide the list of fields for a country for which you want the payment rules to be applied. For example, you can send a request for AU ACH and this API will respond with the rules for AU ACH. This API is built on PIUID 949 rules which includes fields required for each country and for each supported payment method. **Content Type:** Supports application/xml or application/json. **Authorization:** The OAuth Token prefixed with Bearer and space in between. **Request:** Specify all mandatory values in the ISOXML V3 (pain.001.001.03) file at a minimum.' operationId: PaymentValidation parameters: - name: client_id in: query description: unique identifier which created during onboarding process required: true schema: type: string - name: Content-Type in: header description: Supports \"application/xml\" and \"application/json\". required: true schema: type: string - name: Authorization in: header description: The OAuth Token prefixed with "Bearer" and space in between. required: true schema: type: string requestBody: description: Contains the required fields of the ISOXML request body. The request body must be Base64 encoded and enclosed within the \\ tags. content: application/xml: schema: $ref: '#/components/schemas/ValidationRequest' example: Wire_SZD_API_14012020-02-20T09:30:471200MSA ILE DE FRANCEADDRDept001Subdept001street name011132323701234567777777townname1townname1townnasubdivctry01GB248840001TRClient5Wire_SZD_FD_API_1401TRF2020-07-22MSA ILE DE FRANCEADDRDept001street name011132323701234567777777townname1subdivctry01SZ789652CADCITICA5AXXX248840001SN41741MSN41741MURGPOTHR200SHARSOGEADPPXXXBene Bank NameWellsprings RenaissancBuilding No 0271492NewtownshipsADRehanHOMEMumbai113232123456ADAD120001203020035910010012796190145799300 application/json: schema: $ref: '#/components/schemas/ValidationRequest' examples: Payment-Validation-Request-Json: $ref: '#/components/examples/Payment-Validation-Request-Json' required: true responses: '200': description: 200 OK content: application/xml: schema: $ref: '#/components/schemas/Document' example: Wire_SZD_API_14012020-02-20T09:30:47MSA ILE DE FRANCEADDRDept001Subdept001street name011132323701234567777777townname1townname1townnasubdivctry01GB248840001TRClient5Wire_SZD_API_1401Pain.001.001.032020-02-20T09:30:471200Wire_SZD_FD_API_1401SN41741MSN41741MACCP2002020-07-22URGPOTHRTRF12796190145799300MSA ILE DE FRANCEADDRDept001street name011132323701234567777777townname1subdivctry01SZ789652CADCITICA5AXXX248840001SOGEADPPXXXBene Bank NameWellsprings RenaissancBuilding No 0271492NewtownshipsADRehanHOMEMumbai113232123456ADAD1200012030200359100100 application/json: schema: $ref: '#/components/schemas/Document' examples: Payment-Validation-Response-Json: $ref: '#/components/examples/Payment-Validation-Response-Json' '400': description: Bad Request content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 400Mismatch of WorldLink Client ID or Client ID not maintainedq2te~8b8b4912-1b37-449a-9e1a-3401d7ab7d8312198 application/json: schema: $ref: '#/components/schemas/Error-Message' example: correlationId: q2te~bd8e9b8f-d8e5-4a48-ad13-5d1ec8bb32e815587 message: Mismatch of WorldLink client ID or client ID is not maintained. status: '400' '401': description: Unauthorized content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 401Invalid OAuth TokenPlease use valid OAuth Token application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Unauthorized httpCode: '401' moreInformation: This server could not verify that you are authorized to access the URL '404': description: Not found content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 404Not FoundNo resources match requested URI application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Not Found httpCode: '404' moreInformation: No resources match requested URI '405': description: Method Not Allowed content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 405Method Not AllowedThe method is not allowed for the requested URL application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Method Not Allowed httpCode: '405' moreInformation: The method is not allowed for the requested URL '415': description: Unsupported Media Type content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 415Unsupported Media TypeUnsupported Content-Type application/json: schema: $ref: '#/components/schemas/Error-Message' example: httpMessage: Unsupported Media Type httpCode: '415' moreInformation: Unsupported Content-Type '500': description: Internal Server Error content: application/xml: schema: $ref: '#/components/schemas/Error-Message' example: 500Unable to process your requestq2te~8b8b4912-1b37-449a-9e1a-3401d7ab7d8312352 application/json: schema: $ref: '#/components/schemas/Error-Message' example: message: Unable to process your request status: '500' correlationId: q2te~8b8b4912-1b37-449a-9e1a-3401d7ab7d8312352 x-codegen-request-body-name: body components: schemas: StatusReason6Choice: type: object properties: Cd: maxLength: 4 minLength: 1 type: string description: Reason for the status, as published in an external reason code list. Prtry: type: object description: Reason for the status, in a proprietary form. allOf: - $ref: '#/components/schemas/Max35Text' description: Specifies the reason for the status report. Either Code or Proprietary field value should be passed on request. FinancialIdentificationSchemeName1Choice: type: object properties: Cd: maxLength: 4 minLength: 1 type: string description: Specifies the external financial institution identification scheme name code in the format of character string with a maximum length of 4 characters.The list of valid codes is an external code list published separately. Prtry: type: object description: Name of the identification scheme, in a free text form. allOf: - $ref: '#/components/schemas/Max35Text' description: Name of the identification scheme. Either Code or Proprietary field value should be passed on request. DocumentAdjustment1: required: - Amt type: object properties: AddtlInf: type: object description: Provides further details on the document adjustment. allOf: - $ref: '#/components/schemas/Max140Text' Amt: type: object description: Amount of money of the document adjustment. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' CdtDbtInd: $ref: '#/components/schemas/CreditDebitCode' Rsn: type: object description: Specifies the reason for the adjustment. allOf: - $ref: '#/components/schemas/Max4Text' Max140Text: maxLength: 140 minLength: 1 type: string Max15NumericText: pattern: '[0-9]{1,15}' type: string RemittanceInformation5: type: object properties: Strd: type: array description: Information supplied to enable the matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system, in a structured form. items: $ref: '#/components/schemas/StructuredRemittanceInformation7' Ustrd: type: array description: Information supplied to enable the matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system, in an unstructured form. items: $ref: '#/components/schemas/Max140Text' PersonIdentification5: type: object properties: DtAndPlcOfBirth: $ref: '#/components/schemas/DateAndPlaceOfBirth' Othr: type: array description: Unique identification of a person, as assigned by an institution, using an identification scheme. items: $ref: '#/components/schemas/GenericPersonIdentification1' description: Unique and unambiguous identification of a person, for example a passport. LocalInstrument2Choice: type: object properties: Cd: type: object description: Specifies the external local instrument code in the format of character string with a maximum length of 35 characters.The list of valid codes is an external code list published separately. allOf: - $ref: '#/components/schemas/Max35Text' Prtry: type: object description: Specifies the local instrument, as a proprietary code. allOf: - $ref: '#/components/schemas/Max35Text' description: User community specific instrument. Either Code or Proprietary field value should be passed in request. ISODate: type: string format: date BranchData2: type: object properties: Id: type: object description: Unique and unambiguous identification of a branch of a financial institution. allOf: - $ref: '#/components/schemas/Max35Text' Nm: type: object description: Name by which an agent is known and which is usually used to identify that agent. allOf: - $ref: '#/components/schemas/Max140Text' PstlAdr: $ref: '#/components/schemas/PostalAddress6' description: Identifies a specific branch of a financial institution. FinancialInstitutionIdentification7: type: object properties: BIC: pattern: '[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}' type: string description: Code allocated to a financial institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication messages - Business identifier code (BIC)". ClrSysMmbId: $ref: '#/components/schemas/ClearingSystemMemberIdentification2' Nm: type: object description: Name by which an agent is known and which is usually used to identify that agent. allOf: - $ref: '#/components/schemas/Max140Text' Othr: $ref: '#/components/schemas/GenericFinancialIdentification1' PstlAdr: $ref: '#/components/schemas/PostalAddress6' description: Unique and unambiguous identification of a financial institution, as assigned under an internationally recognised or proprietary identification scheme. AmendmentInformationDetails6: type: object properties: OrgnlMndtId: type: object description: Unique identification, as assigned by the creditor, to unambiguously identify the original mandate. allOf: - $ref: '#/components/schemas/Max35Text' OrgnlCdtrSchmeId: type: object description: Original creditor scheme identification that has been modified. allOf: - $ref: '#/components/schemas/PartyIdentification32' OrgnlDbtr: type: object description: Original debtor that has been modified. allOf: - $ref: '#/components/schemas/PartyIdentification32' OrgnlDbtrAcct: type: object description: Original debtor account that has been modified. allOf: - $ref: '#/components/schemas/CashAccount16' OrgnlDbtrAgt: type: object description: Original debtor agent that has been modified. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' OrgnlDbtrAgtAcct: type: object description: Original debtor agent account that has been modified. allOf: - $ref: '#/components/schemas/CashAccount16' OrgnlCdtrAgt: type: object description: Original creditor agent that has been modified. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' OrgnlCdtrAgtAcct: type: object description: Original creditor agent acount that has been modified. allOf: - $ref: '#/components/schemas/CashAccount16' OrgnlFnlColltnDt: type: string description: Original final collection date that has been modified. format: date OrgnlFrqcy: $ref: '#/components/schemas/Frequency1Code' description: List of mandate elements that have been modified. DocumentType5Code: type: string description: 'Document type in a coded form.

MSIN : Document is an invoice claiming payment for the supply of metered services, for example gas or electricity supplied to a fixed meter.

CNFA : Document is a credit note for the final amount settled for a commercial transaction.

DNFA : Document is a debit note for the final amount settled for a commercial transaction.

CINV : Document is an invoice.

CREN : Document is a credit note.

DEBN : Document is a debit note.

HIRI : Document is an invoice for the hiring of human resources or renting goods or equipment.

SBIN : Document is an invoice issued by the debtor.

SVGS : Account used for savings.

CMCN : Document is an agreement between the parties, stipulating the terms and conditions of the delivery of goods or services.

SOAC : Document is a statement of the transactions posted to the debtor''s account at the supplier.

DISP : Document is a dispatch advice.

BOLD : Document is a shipping notice.

VCHR : Document is an electronic payment document.

AROI : Document is a payment that applies to a specific source document.

TSUT : Document is a transaction identifier as assigned by the Trade Services Utility.' enum: - MSIN - CNFA - DNFA - CINV - CREN - DEBN - HIRI - SBIN - CMCN - SOAC - DISP - BOLD - VCHR - AROI - TSUT ChargesInformation5: required: - Amt - Pty type: object properties: Amt: type: object description: Transaction charges to be paid by the charge bearer. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' Pty: type: object description: Party that takes the transaction charges or to which the transaction charges are due. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' StatusReasonInformation8: type: object properties: Orgtr: type: object description: Party that issues the status. allOf: - $ref: '#/components/schemas/PartyIdentification32' Rsn: $ref: '#/components/schemas/StatusReason6Choice' AddtlInf: type: array description: Further details on the status reason. items: $ref: '#/components/schemas/Max105Text' PostalAddress6: type: object properties: AdrLine: maxItems: 7 type: array description: Information that locates and identifies a specific address, as defined by postal services, presented in free format text. items: $ref: '#/components/schemas/Max70Text' AdrTp: type: string description: 'Identifies the nature of the postal address.

ADDR : Address is the complete postal address.

PBOX : Address is a postal office (PO) box.

HOME : Address is the home address.

BIZZ : Address is the business address.

MLTO : Address is the address to which mail is sent.

DLVY : Address is the address to which delivery is to take place.' enum: - ADDR - PBOX - HOME - BIZZ - MLTO - DLVY BldgNb: type: object description: Number that identifies the position of a building on a street. allOf: - $ref: '#/components/schemas/Max16Text' Ctry: $ref: '#/components/schemas/CountryCode' CtrySubDvsn: type: object description: Identifies a subdivision of a country such as state, region, county. allOf: - $ref: '#/components/schemas/Max35Text' Dept: type: object description: Identification of a division of a large organisation or building. allOf: - $ref: '#/components/schemas/Max70Text' PstCd: type: object description: Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail. allOf: - $ref: '#/components/schemas/Max16Text' StrtNm: type: object description: Name of a street or thoroughfare. allOf: - $ref: '#/components/schemas/Max70Text' SubDept: type: object description: Identification of a sub-division of a large organisation or building. allOf: - $ref: '#/components/schemas/Max70Text' TwnNm: type: object description: Name of a built-up area, with defined boundaries, and a local government. allOf: - $ref: '#/components/schemas/Max35Text' description: Information that locates and identifies a specific address, as defined by postal services. RemittanceAmount1: type: object properties: AdjstmntAmtAndRsn: type: array description: Set of elements used to provide information on the amount and reason of the document adjustment. items: $ref: '#/components/schemas/DocumentAdjustment1' CdtNoteAmt: type: object description: Amount specified for the referred document is the amount of a credit note. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' DscntApldAmt: type: object description: Amount of money that results from the application of an agreed discount to the amount due and payable to the creditor. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' DuePyblAmt: type: object description: Amount specified is the exact amount due and payable to the creditor. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' RmtdAmt: type: object description: Amount of money remitted for the referred document. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' TaxAmt: type: object description: Quantity of cash resulting from the calculation of the tax. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' description: Set of elements used to provide details on the amounts of the referred document. SettlementMethod1Code: type: string description: 'Method used to settle the (batch of) payment instructions.

INDA : Settlement is done by the agent instructed to execute a payment instruction.

INGA : Settlement is done by the agent instructing and forwarding the payment to the next party in the payment chain.

COVE : Settlement is done through a cover payment.

CLRG : Settlement is done through a payment clearing system.' enum: - INDA - INGA - COVE - CLRG Error-Message: type: object properties: correlationId: type: string httpCode: type: string httpMessage: type: string moreInformation: type: string description: Error response body. ActiveOrHistoricCurrencyCode: pattern: '[A-Z]{3,3}' type: string Document: type: object properties: CstmrPmtStsRpt: $ref: '#/components/schemas/CustomerPaymentStatusReportV03' ReferredDocumentInformation3: type: object properties: Nb: type: object description: Unique and unambiguous identification of the referred document. allOf: - $ref: '#/components/schemas/Max35Text' RltdDt: type: object description: Date associated with the referred document. allOf: - $ref: '#/components/schemas/ISODate' Tp: $ref: '#/components/schemas/ReferredDocumentType2' TransactionIndividualStatus3Code: type: string description: 'Common transaction status for all individual transactions reported.

ACTC : Authentication and syntactical and semantical validation are successful.

RJCT : Payment initiation or individual transaction included in the payment initiation has been rejected.

PDNG : Payment initiation or individual transaction included in the payment initiation is pending. Further checks and status update will be performed.

ACCP : Preceding check of technical validation was successful. Customer profile check was also successful.

ACSP : All preceding checks such as technical validation and customer profile were successful and therefore the payment initiation has been accepted for execution.

ACSC : Settlement on the debtor''s account has been completed. Usage : this can be used by the first agent to report to the debtor that the transaction has been completed. Warning : this status is provided for transaction status reasons, not for financial information. It can only be used after bilateral agreement

ACWC : Instruction is accepted but a change will be made, such as date or remittance not sent.' enum: - ACTC - RJCT - PDNG - ACCP - ACSP - ACSC - ACWC StructuredRemittanceInformation7: type: object properties: AddtlRmtInf: maxItems: 3 type: array description: Additional information, in free text form, to complement the structured remittance information. items: $ref: '#/components/schemas/Max140Text' CdtrRefInf: $ref: '#/components/schemas/CreditorReferenceInformation2' Invcee: type: object description: Identification of the party to whom an invoice is issued, when it is different from the debtor or ultimate debtor. allOf: - $ref: '#/components/schemas/PartyIdentification32' Invcr: type: object description: Identification of the organisation issuing the invoice, when it is different from the creditor or ultimate creditor. allOf: - $ref: '#/components/schemas/PartyIdentification32' RfrdDocAmt: $ref: '#/components/schemas/RemittanceAmount1' RfrdDocInf: type: array description: Set of elements used to identify the documents referred to in the remittance information. items: $ref: '#/components/schemas/ReferredDocumentInformation3' PaymentTransactionInformation25: type: object properties: StsId: type: object description: Unique identification, as assigned by an instructing party for an instructed party, to unambiguously identify the reported status. allOf: - $ref: '#/components/schemas/Max35Text' OrgnlInstrId: type: object description: Unique identification, as assigned by the original instructing party for the original instructed party, to unambiguously identify the original instruction. allOf: - $ref: '#/components/schemas/Max35Text' OrgnlEndToEndId: type: object description: Unique identification, as assigned by the original initiating party, to unambiguously identify the original transaction. allOf: - $ref: '#/components/schemas/Max35Text' TxSts: $ref: '#/components/schemas/TransactionIndividualStatus3Code' StsRsnInf: type: array description: Set of elements used to provide detailed information on the status reason. items: $ref: '#/components/schemas/StatusReasonInformation8' ChrgsInf: type: array description: Provides information on the charges related to the processing of the rejection of the instruction. items: $ref: '#/components/schemas/ChargesInformation5' AccptncDtTm: type: string description: Point in time when the payment order from the initiating party meets the processing conditions of the account servicing agent. This means that the account servicing agent has received the payment order and has applied checks such as authorisation, availability of funds. format: date-time AcctSvcrRef: type: object description: Unique reference, as assigned by the account servicing institution, to unambiguously identify the instruction. allOf: - $ref: '#/components/schemas/Max35Text' ClrSysRef: type: object description: Unique reference, as assigned by a clearing system, to unambiguously identify the instruction. allOf: - $ref: '#/components/schemas/Max35Text' OrgnlTxRef: $ref: '#/components/schemas/OriginalTransactionReference13' TransactionGroupStatus3Code: type: string description: 'Specifies the status of a group of transactions.

ACTC : Authentication and syntactical and semantical validation are successful.

RCVD : Payment initiation has been received by the receiving agent.

PART : A number of transactions have been accepted, whereas another number of transactions have not yet achieved ''accepted'' status.

RJCT : Payment initiation or individual transaction included in the payment initiation has been rejected.

PDNG : Payment initiation or individual transaction included in the payment initiation is pending. Further checks and status update will be performed.

ACCP : Preceding check of technical validation was successful. Customer profile check was also successful.

ACSP : All preceding checks such as technical validation and customer profile were successful and therefore the payment initiation has been accepted for execution.

ACSC : Settlement on the debtor''s account has been completed. Usage : this can be used by the first agent to report to the debtor that the transaction has been completed. Warning : this status is provided for transaction status reasons, not for financial information. It can only be used after bilateral agreement

ACWC : Instruction is accepted but a change will be made, such as date or remittance not sent.' enum: - ACTC - RCVD - PART - RJCT - PDNG - ACCP - ACSP - ACSC - ACWC Priority2Code: type: string description: 'Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction.

HIGH : Priority level is high.

NORM : Priority level is normal.' enum: - HIGH - NORM Frequency1Code: type: string description: 'Original frequency that has been modified.

YEAR : Event takes place every year or once a year.

MNTH : Event takes place every month or once a month.

QURT : Event takes place every three months or four times a year.

MIAN : Event takes place every six months or two times a year.

WEEK : Event takes place once a week.

DAIL : Event takes place every day.

ADHO : Event takes place on request or as necessary.

INDA : Event takes place several times a day.' enum: - YEAR - MNTH - QURT - MIAN - WEEK - DAIL - ADHO - INDA Max105Text: maxLength: 105 minLength: 1 type: string PhoneNumber: pattern: \+[0-9]{1,3}-[0-9()+\-]{1,30} type: string NamePrefix1Code: type: string description: 'Specifies the terms used to formally address a person.

DOCT : Title of the person is Doctor or Dr.

MIST : Title of the person is Mister or Mr.

MISS : Title of the person is Miss.

MADM : Title of the person is Madam.' enum: - DOCT - MIST - MISS - MADM CreditorReferenceInformation2: type: object properties: Ref: type: object description: Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. allOf: - $ref: '#/components/schemas/Max35Text' Tp: $ref: '#/components/schemas/CreditorReferenceType2' description: Reference information provided by the creditor to allow the identification of the underlying documents. PaymentMethod4Code: type: string description: 'Specifies the means of payment that will be used to move the amount of money.

CHK : Written order to a bank to pay a certain amount of money from one person to another person.

TRF : Transfer of an amount of money in the books of the account servicer.

DD : Collection of an amount of money from the debtor''s bank account by the creditor. The amount of money and dates of collections may vary.

TRA : Transfer of an amount of money in the books of the account servicer. An advice should be sent back to the account owner.' enum: - CHK - TRF - DD - TRA NumberOfTransactionsPerStatus3: required: - DtldNbOfTxs - DtldSts type: object properties: DtldNbOfTxs: type: object description: Number of individual transactions contained in the message, detailed per status. allOf: - $ref: '#/components/schemas/Max15NumericText' DtldCtrlSum: maxLength: 18 type: string description: Total of all individual amounts included in the message, irrespective of currencies, detailed per status. The number of fractional digits should not be more than 17 DtldSts: $ref: '#/components/schemas/TransactionIndividualStatus3Code' GenericFinancialIdentification1: required: - Id type: object properties: Id: type: object description: Unique and unambiguous identification of a person. allOf: - $ref: '#/components/schemas/Max35Text' Issr: type: object description: Entity that assigns the identification. allOf: - $ref: '#/components/schemas/Max35Text' SchmeNm: $ref: '#/components/schemas/FinancialIdentificationSchemeName1Choice' description: Unique identification of an agent, as assigned by an institution, using an identification scheme. ActiveOrHistoricCurrencyAndAmount: required: - Ccy type: object properties: Ccy: type: object description: Currency code. Passed as the tag attribute.The unit of currency is explicit and compliant with ISO 4217 allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyCode' $: $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount_SimpleType' GenericOrganisationIdentification1: required: - Id type: object properties: Id: maxLength: 35 minLength: 1 type: string SchmeNm: type: object allOf: - $ref: '#/components/schemas/OrganisationIdentificationSchemeName1Choice' Issr: maxLength: 35 minLength: 1 type: string description: Unique identification of an organisation, as assigned by an institution, using an identification scheme. GenericAccountIdentification1: required: - Id type: object properties: Id: maxLength: 34 minLength: 1 type: string description: Identification assigned by an institution. Issr: type: object description: Entity that assigns the identification. allOf: - $ref: '#/components/schemas/Max35Text' SchmeNm: type: object description: Name of the identification scheme.Either Code or Proprietary is required allOf: - $ref: '#/components/schemas/FinancialIdentificationSchemeName1Choice' description: Unique identification of an account, as assigned by the account servicer, using an identification scheme. OriginalPaymentInformation1: required: - OrgnlPmtInfId type: object properties: OrgnlPmtInfId: type: object description: Unique identification, as assigned by the original sending party, to unambiguously identify the original payment information group. allOf: - $ref: '#/components/schemas/Max35Text' OrgnlNbOfTxs: type: object description: Number of individual transactions contained in the original payment information group. allOf: - $ref: '#/components/schemas/Max15NumericText' OrgnlCtrlSum: maxLength: 18 type: string description: Total of all individual amounts included in the original payment information group, irrespective of currencies. The number of fractional digits should not be more than 17. PmtInfSts: type: object description: 'Specifies the status of the payment information group.

ACTC : Authentication and syntactical and semantical validation are successful.

RCVD : Payment initiation has been received by the receiving agent.

PART : A number of transactions have been accepted, whereas another number of transactions have not yet achieved ''accepted'' status.

RJCT : Payment initiation or individual transaction included in the payment initiation has been rejected.

PDNG : Payment initiation or individual transaction included in the payment initiation is pending. Further checks and status update will be performed.

ACCP : Preceding check of technical validation was successful. Customer profile check was also successful.

ACSP : All preceding checks such as technical validation and customer profile were successful and therefore the payment initiation has been accepted for execution.

ACSC : Settlement on the debtor''s account has been completed. Usage : this can be used by the first agent to report to the debtor that the transaction has been completed. Warning : this status is provided for transaction status reasons, not for financial information. It can only be used after bilateral agreement

ACWC : Instruction is accepted but a change will be made, such as date or remittance not sent.' allOf: - $ref: '#/components/schemas/TransactionGroupStatus3Code' StsRsnInf: type: array description: Set of elements used to provide detailed information on the status reason. items: $ref: '#/components/schemas/StatusReasonInformation8' NbOfTxsPerSts: type: array description: Detailed information on the number of transactions for each identical transaction status. items: $ref: '#/components/schemas/NumberOfTransactionsPerStatus3' TxInfAndSts: type: array description: Payment transaction information and status. items: $ref: '#/components/schemas/PaymentTransactionInformation25' PaymentTypeInformation22: type: object properties: InstrPrty: $ref: '#/components/schemas/Priority2Code' ClrChanl: type: string description: 'Specifies the clearing channel to be used to process the payment instruction.

RTGS : Clearing channel is a real-time gross settlement system.

RTNS : Clearing channel is a real-time net settlement system.

MPNS : Clearing channel is a mass payment net settlement system.

BOOK : Payment through internal book transfer.' enum: - RTGS - RTNS - MPNS - BOOK SvcLvl: $ref: '#/components/schemas/ServiceLevel8Choice' LclInstrm: $ref: '#/components/schemas/LocalInstrument2Choice' SeqTp: type: string description: 'Identifies the direct debit sequence, such as first, recurrent, final or one-off.

FRST : First collection of a series of direct debit instructions.

RCUR : Direct debit instruction where the debtor''s authorisation is used for regular direct debit transactions initiated by the creditor.

FNAL : Final collection of a series of direct debit instructions.

OOFF : Direct debit instruction where the debtor''s authorisation is used to initiate one single direct debit transaction.' enum: - FRST - RCUR - FNAL - OOFF CtgyPurp: $ref: '#/components/schemas/CategoryPurpose1Choice' description: Set of elements used to further specify the type of transaction. GroupHeader36: required: - CreDtTm - MsgId type: object properties: CreDtTm: type: string description: Date and time at which the message was created. format: date-time FwdgAgt: type: object description: Financial institution that receives the instruction from the initiating party and forwards it to the next agent in the payment chain. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' DbtrAgt: type: object description: Financial institution servicing an account for the debtor. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' CdtrAgt: type: object description: Financial institution servicing an account for the creditor. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' InitgPty: type: object description: Party that initiates the status message. allOf: - $ref: '#/components/schemas/PartyIdentification32' MsgId: maxLength: 35 minLength: 1 type: string description: Point to point reference, as assigned by the instructing party, and sent to the next party in the chain to unambiguously identify the message. description: Set of characteristics shared by all individual transactions included in the message. disclosure_request: type: object properties: in: required: - bankCode - bankCodeType - chargeCode - clientId - destinationCountry - estimatePercentile - flagFutureDated - flagODE - fundingCurrency - isBeneDeduct - nonSTPFlag - paymentCurrency - paymentCurrencyAmount - paymentMethod - releaseTime - valueDate - subEntityId - beneDeductFeeType - nostroCountry type: object properties: clientId: maxLength: 5 type: string description: WorldLink specific client number if using WorldLink routing. subEntityId: maxLength: 4 type: string description: WorldLink Branch (Sub entity number). destinationCountry: maxLength: 2 type: string description: Value any country through or to which CITI transfers money via Fed Wire or ACH. destinationState: maxLength: 35 type: string description: Destination State. If the full state or province is available it may be passed here. If this is in the database it will return the value, otherwise it will default. This entry is for tax calculation only. destinationCity: maxLength: 35 type: string description: Destination City. If the full City is available it may be passed here. If this is in the database it will return the value, otherwise it will default. This entry is for tax calculation only. bankCode: maxLength: 20 type: string description: ID of bank through which money can be sent. This is used in conjunction with Bank Code Type. bankCodeType: maxLength: 1 type: string description: This is used in conjunction with Bank Code B-BIC. paymentMethod: maxLength: 1 type: string description: As a default pass 'W'ire W (wire), A (ACH), C (Cash) paymentCurrency: maxLength: 3 type: string description: Payment currency SWIFT(ISO) code. fundingCurrency: maxLength: 3 type: string description: Funding currency SWIFT(ISO) code. paymentCurrencyAmount: type: number description: Decimals dependent on currency number 19,3 .Between 0.00 and 9999999999999999.999 nonSTPFlag: maxLength: 1 type: string description: This will always default to ā€˜N’ for straight through processing. Always pass ā€˜N’. citiPointOfOrigination: maxLength: 2 type: string description: Location of Nostro account or US. Allowable Value(2 characters) or space. Not allowed unless bank code is present. This tag may be used if the client is not routing through the WorldLink Omnibus accounts. Use of this value is to be coordinated with the DF Table administrator. isBeneDeduct: maxLength: 1 type: string description: Accesses Bene Deduct table if Yes [Y]. Client should pass 'Y' if they know bene deduct fees are being applied. enum: - Y - N beneDeductFeeType: maxLength: 1 type: string description: Flat(F) or Tiered(T). Value must be present if Bene Deduct indicator is Y. Spaces or no tag transmitted if Bene Deduct is N. enum: - F - T estimatePercentile: type: integer description: Estimate Percentile (80, 90 or 95) (required in case fee found is estimated, the API will return the appropriate value) chargeCode: maxLength: 3 type: string description: 'BEN -- fees charged to beneficiaries SHA -- fees shared OUR -- Fees by bank/RTP ' releaseTime: type: string description: 'Time that transactions will be released after the designated hold period. Format: yyyy-mm-ddThh:mm:ss.' nostroCountry: type: string description: Valid two digit country code. flagODE: type: string description: Our Deduct Flag. Both isBeneDeduct and flagODE, can't be Y, at the same time. When flagODE is Y, ChargeCode can't be anything other than OUR enum: - Y - N valueDate: type: string description: Value date for the payment. format: date flagFutureDated: maxLength: 1 type: string description: Indicates whether it is future dated transaction. enum: - Y - N example: clientId: '24884' subEntityId: '0001' destinationCountry: IN destinationState: AK destinationCity: ANCHORAGE bankCode: CITIIN00 bankCodeType: B paymentMethod: W paymentCurrency: INR fundingCurrency: USD paymentCurrencyAmount: 100 nonSTPFlag: N isBeneDeduct: Y citiPointOfOrigination: US estimatePercentile: 95 chargeCode: OPT releaseTime: '2019-11-28T16:11:23.000' nostroCountry: AU valueDate: '2019-11-28' flagFutureDated: N flagODE: Y beneDeductFeeType: F PersonIdentificationSchemeName1Choice: type: object properties: Cd: maxLength: 4 minLength: 1 type: string description: Specifies the external person identification scheme name code in the format of character string with a maximum length of 4 characters.The list of valid codes is an external code list published separately. Prtry: maxLength: 35 minLength: 1 type: string description: Description of Propreitary description: Either Code or Proprietary is required DateAndPlaceOfBirth: required: - BirthDt - CityOfBirth - CtryOfBirth type: object properties: BirthDt: type: object description: Date on which a person is born. allOf: - $ref: '#/components/schemas/ISODate' PrvcOfBirth: type: object description: Province where a person was born. allOf: - $ref: '#/components/schemas/Max35Text' CityOfBirth: type: object description: City where a person was born. allOf: - $ref: '#/components/schemas/Max35Text' CtryOfBirth: type: object description: Country where a person was born. allOf: - $ref: '#/components/schemas/CountryCode' description: Date and place of birth of a person. BranchAndFinancialInstitutionIdentification4: required: - FinInstnId type: object properties: BrnchId: $ref: '#/components/schemas/BranchData2' FinInstnId: $ref: '#/components/schemas/FinancialInstitutionIdentification7' MandateRelatedInformation6: type: object properties: MndtId: type: object description: Unique identification, as assigned by the creditor, to unambiguously identify the mandate. allOf: - $ref: '#/components/schemas/Max35Text' AmdmntInd: type: boolean description: Indicator notifying whether the underlying mandate is amended or not. AmdmntInfDtls: $ref: '#/components/schemas/AmendmentInformationDetails6' ElctrncSgntr: maxLength: 1025 minLength: 1 type: string description: Additional security provisions, such as a digital signature, as provided by the debtor. DtOfSgntr: type: string description: Date on which the direct debit mandate has been signed by the debtor. format: date FrstColltnDt: type: string description: Date of the first collection of a direct debit as per the mandate. format: date FnlColltnDt: type: string description: Date of the final collection of a direct debit as per the mandate. format: date Frqcy: $ref: '#/components/schemas/Frequency1Code' description: Set of elements used to provide further details of the mandate signed between the creditor and the debtor. ClearingSystemIdentification3Choice: type: object properties: Cd: maxLength: 3 minLength: 1 type: string description: Infrastructure through which the payment instruction is processed, as published in an external clearing system identification code list.Specifies the cash clearing system, as published in an external cash clearing system code list. Prtry: type: object description: Clearing system identification in a proprietary form. allOf: - $ref: '#/components/schemas/Max35Text' description: Specification of a pre-agreed offering between clearing agents or the channel through which the payment instruction is processed. Either Code or Proprietary field value should be passed in request. OrganisationIdentificationSchemeName1Choice: type: object properties: Cd: maxLength: 4 minLength: 1 type: string description: Specifies the external organisation identification scheme name code in the format of character string with a maximum length of 4 characters.The list of valid codes is an external code list published separately. Prtry: maxLength: 35 minLength: 1 type: string description: Description for Proprietary description: Name of the identification scheme.Sets of elements to identify a name of the organisation identification scheme. Either Code or Proprietary is required GenericPersonIdentification1: required: - Id type: object properties: Id: maxLength: 35 minLength: 1 type: string description: Unique and unambiguous identification of a person. Issr: maxLength: 35 minLength: 1 type: string description: Entity that assigns the identification. SchmeNm: type: object description: Name of the identification scheme.Sets of elements to identify a name of the identification scheme. Either Code or Proprietary is required allOf: - $ref: '#/components/schemas/PersonIdentificationSchemeName1Choice' description: Unique identification of a person, as assigned by an institution, using an identification scheme. Max16Text: maxLength: 16 minLength: 1 type: string PartyIdentification32: type: object properties: Nm: type: object description: Name by which a party is known and which is usually used to identify that party. allOf: - $ref: '#/components/schemas/Max140Text' PstlAdr: $ref: '#/components/schemas/PostalAddress6' Id: type: object properties: OrgId: $ref: '#/components/schemas/OrganisationIdentification4' PrvtId: $ref: '#/components/schemas/PersonIdentification5' description: Unique and unambiguous identification of a party. Should pass either OrgId or PrvtId for organisation and private respectively. CtryOfRes: type: object description: Country in which a person resides (the place of a person's home). In the case of a company, it is the country from which the affairs of that company are directed. allOf: - $ref: '#/components/schemas/CountryCode' CtctDtls: $ref: '#/components/schemas/ContactDetails2' Max70Text: maxLength: 70 minLength: 1 type: string ReferredDocumentType2: required: - CdOrPrtry type: object properties: CdOrPrtry: $ref: '#/components/schemas/ReferredDocumentType1Choice' Issr: type: object description: Identification of the issuer of the reference document type. allOf: - $ref: '#/components/schemas/Max35Text' description: Specifies the type of referred document. OriginalGroupInformation20: required: - OrgnlMsgId - OrgnlMsgNmId type: object properties: OrgnlMsgId: type: object description: Point to point reference, as assigned by the original instructing party, to unambiguously identify the original message. allOf: - $ref: '#/components/schemas/Max35Text' OrgnlMsgNmId: type: object description: Specifies the original message name identifier to which the message refers. allOf: - $ref: '#/components/schemas/Max35Text' OrgnlCreDtTm: type: string description: Date and time at which the original message was created. format: date-time OrgnlNbOfTxs: type: object description: Number of individual transactions contained in the original message. allOf: - $ref: '#/components/schemas/Max15NumericText' OrgnlCtrlSum: maxLength: 18 type: string description: Total of all individual amounts included in the original message, irrespective of currencies. The number of fractional digits should not be more than 17. GrpSts: $ref: '#/components/schemas/TransactionGroupStatus3Code' StsRsnInf: type: array description: Set of elements used to provide detailed information on the status reason. items: $ref: '#/components/schemas/StatusReasonInformation8' NbOfTxsPerSts: type: array description: Detailed information on the number of transactions for each identical transaction status. items: $ref: '#/components/schemas/NumberOfTransactionsPerStatus3' description: Original group information concerning the group of transactions, to which the status report message refers to. ClearingSystemMemberIdentification2: required: - MmbId type: object properties: ClrSysId: type: object properties: Cd: maxLength: 5 minLength: 1 type: string description: It Specifies the clearing system identification code, as published in an external clearing system identification code list. Prtry: type: object description: Identification code for a clearing system, that has not yet been identified in the list of clearing systems. allOf: - $ref: '#/components/schemas/Max35Text' description: Specification of a pre-agreed offering between clearing agents or the channel through which the payment instruction is processed.Either from Code Or Proprietary is required MmbId: type: object description: Identification of a member of a clearing system. allOf: - $ref: '#/components/schemas/Max35Text' description: Information used to identify a member within a clearing system. ActiveOrHistoricCurrencyAndAmount_SimpleTypeStatusInquiry: type: string description: Upto 3 fraction digits allowed ContactDetails2: type: object properties: EmailAdr: type: object description: Address for electronic mail (e-mail). allOf: - $ref: '#/components/schemas/Max2048Text' FaxNb: type: object description: Collection of information that identifies a FAX number, as defined by telecom services. allOf: - $ref: '#/components/schemas/PhoneNumber' MobNb: type: object description: Collection of information that identifies a mobile phone number, as defined by telecom services. allOf: - $ref: '#/components/schemas/PhoneNumber' Nm: type: object description: Name by which a party is known and which is usually used to identify that party. allOf: - $ref: '#/components/schemas/Max140Text' NmPrfx: $ref: '#/components/schemas/NamePrefix1Code' Othr: type: object description: Contact details in another form. allOf: - $ref: '#/components/schemas/Max35Text' PhneNb: type: object description: Collection of information that identifies a phone number, as defined by telecom services. allOf: - $ref: '#/components/schemas/PhoneNumber' description: Set of elements used to indicate how to contact the party. ActiveOrHistoricCurrencyAndAmountStatusInquiry: required: - Amt - Ccy type: object properties: Ccy: type: object description: Currency code. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyCode' Amt: $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount_SimpleTypeStatusInquiry' CountryCode: pattern: '[A-Z]{2,2}' type: string description: Nation with its own government. The code is checked against the list of country names obtained from the United Nations (ISO 3166, Alpha-2 code). CreditDebitCode: type: string description: 'Specifies whether the adjustment must be subtracted or added to the total amount.

CRDT : Operation is an increase.

DBIT : Operation is a decrease.' enum: - CRDT - DBIT DocumentType3Code: type: string description: 'Type of creditor reference, in a coded form.

RADM : Document is a remittance advice sent separately from the current transaction.

RPIN : Document is a linked payment instruction to which the current payment instruction is related, for example, in a cover scenario.

FXDR : Document is a pre-agreed or pre-arranged foreign exchange transaction to which the payment transaction refers.

DISP : Document is a dispatch advice.

PUOR : Document is a purchase order

SCOR : Document is a structured communication reference provided by the creditor to identify the referred transaction.' enum: - RADM - RPIN - FXDR - DISP - PUOR - SCOR OriginalTransactionReference13: type: object properties: IntrBkSttlmAmt: type: object description: Amount of money moved between the instructing agent and the instructed agent. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' Amt: $ref: '#/components/schemas/AmountType3Choice' IntrBkSttlmDt: type: string description: Date on which the amount of money ceases to be available to the agent that owes it and when the amount of money becomes available to the agent to which it is due. format: date ReqdColltnDt: type: string description: Date on which the creditor requests that the amount of money is to be collected from the debtor. format: date ReqdExctnDt: type: string description: Date at which the initiating party requests the clearing agent to process the payment. format: date CdtrSchmeId: type: object description: Credit party that signs the mandate. allOf: - $ref: '#/components/schemas/PartyIdentification32' SttlmInf: $ref: '#/components/schemas/SettlementInformation13' PmtTpInf: $ref: '#/components/schemas/PaymentTypeInformation22' PmtMtd: $ref: '#/components/schemas/PaymentMethod4Code' MndtRltdInf: $ref: '#/components/schemas/MandateRelatedInformation6' RmtInf: $ref: '#/components/schemas/RemittanceInformation5' UltmtDbtr: type: object description: Ultimate party that owes an amount of money to the (ultimate) creditor. allOf: - $ref: '#/components/schemas/PartyIdentification32' Dbtr: type: object description: Party that owes an amount of money to the (ultimate) creditor. allOf: - $ref: '#/components/schemas/PartyIdentification32' DbtrAcct: type: object description: Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction. allOf: - $ref: '#/components/schemas/CashAccount16' DbtrAgt: type: object description: Financial institution servicing an account for the debtor. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' DbtrAgtAcct: type: object description: Unambiguous identification of the account of the debtor agent at its servicing agent in the payment chain. allOf: - $ref: '#/components/schemas/CashAccount16' CdtrAgt: type: object description: Financial institution servicing an account for the creditor. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' CdtrAgtAcct: type: object description: Unambiguous identification of the account of the creditor agent at its servicing agent to which a credit entry will be made as a result of the payment transaction. allOf: - $ref: '#/components/schemas/CashAccount16' Cdtr: type: object description: Party to which an amount of money is due. allOf: - $ref: '#/components/schemas/PartyIdentification32' CdtrAcct: type: object description: Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction. allOf: - $ref: '#/components/schemas/CashAccount16' UltmtCdtr: type: object description: Ultimate party to which an amount of money is due. allOf: - $ref: '#/components/schemas/PartyIdentification32' description: Set of key elements used to identify the original transaction that is being referred to. EquivalentAmount2: required: - Amt - CcyOfTrf type: object properties: Amt: type: object description: Amount of money to be moved between debtor and creditor, before deduction of charges, expressed in the currency of the debtor's account, and to be moved in a different currency. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' CcyOfTrf: type: object description: Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyCode' description: Amount of money to be moved between the debtor and creditor, expressed in the currency of the debtor's account, and the currency in which the amount is to be moved. CategoryPurpose1Choice: type: object properties: Cd: maxLength: 4 minLength: 1 type: string description: Category purpose, as published in an external category purpose code list. Prtry: type: object description: Category purpose, in a proprietary form. allOf: - $ref: '#/components/schemas/Max35Text' description: Specifies the high level purpose of the instruction based on a set of pre-defined categories. Either Code or Proprietary field value should be passed in request. ReferredDocumentType1Choice: type: object properties: Cd: $ref: '#/components/schemas/DocumentType5Code' Prtry: type: object description: Proprietary identification of the type of the remittance document. allOf: - $ref: '#/components/schemas/Max35Text' description: Provides the type details of the referred document. Either Code or Proprietary field value should be passed on request. AccountIdentification4Choice: type: object properties: IBAN: $ref: '#/components/schemas/IBAN2007Identifier' Othr: $ref: '#/components/schemas/GenericAccountIdentification1' description: Unique and unambiguous identification for the account between the account owner and the account servicer. Either iban or Othr field value should be passed on request. AmountType3Choice: type: object properties: EqvtAmt: $ref: '#/components/schemas/EquivalentAmount2' InstdAmt: type: object description: Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmount' description: Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party. Either EqvtAmt or InstdAmt field value should be passed on request. CreditorReferenceType2: required: - CdOrPrtry type: object properties: CdOrPrtry: $ref: '#/components/schemas/CreditorReferenceType1Choice' Issr: type: object description: Entity that assigns the credit reference type. allOf: - $ref: '#/components/schemas/Max35Text' description: Specifies the type of creditor reference. CashAccountType4Code: type: string description: 'Account type, in a coded form.

CASH : Account used for the payment of cash.

CHAR : Account used for charges if different from the account for payment.

COMM : Account used for commission if different from the account for payment.

TAXE : Account used for taxes if different from the account for payment.

CISH : Account used for payment of income if different from the current cash account.

TRAS : Account used for trading if different from the current cash account.

SACC : Account used to post debit and credit entries, as a result of transactions cleared and settled through a specific clearing and settlement system.

CACC : Account used to post debits and credits when no specific account has been nominated.

SVGS : Account used for savings.

ONDP : Account used for overnight deposits.

MGLD : Account used for a marginal lending facility.

NREX : Account used for non-resident external.

MOMA : Account used for money markets if different from the cash account.

LOAN : Account used for loans.

SLRY : Accounts used for salary payments.

ODFT : Account is used for overdrafts.' enum: - CASH - CHAR - COMM - TAXE - CISH - TRAS - SACC - CACC - SVGS - ONDP - MGLD - NREX - MOMA - LOAN - SLRY - ODFT IBAN2007Identifier: pattern: ^[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}$ type: string description: '>- International Bank Account Number (IBAN) - identifier used internationally by financial institutions to uniquely identify the account of a customer. Further specifications of the format and content of the IBAN can be found in the standard ISO 13616 "Banking and related financial services - International Bank Account Number (IBAN)" version 1997-10-01, or later revisions.' OrganisationIdentification4: type: object properties: BICOrBEI: pattern: '[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}' type: string description: Code allocated to a financial institution or non financial institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication messages - Business identifier code (BIC)". Othr: type: array description: Unique identification of an organisation, as assigned by an institution, using an identification scheme. items: $ref: '#/components/schemas/GenericOrganisationIdentification1' description: Unique and unambiguous way to identify an organisation. CreditorReferenceType1Choice: type: object properties: Cd: $ref: '#/components/schemas/DocumentType3Code' Prtry: type: object description: Creditor reference type, in a proprietary form. allOf: - $ref: '#/components/schemas/Max35Text' description: Coded or proprietary format creditor reference type. Either Code or Proprietary field value should be passed on request. SettlementInformation13: required: - SttlmMtd type: object properties: SttlmMtd: $ref: '#/components/schemas/SettlementMethod1Code' SttlmAcct: type: object description: A specific purpose account used to post debit and credit entries as a result of the transaction. allOf: - $ref: '#/components/schemas/CashAccount16' InstgRmbrsmntAgtAcct: type: object description: Unambiguous identification of the account of the instructing reimbursement agent account at its servicing agent in the payment chain. allOf: - $ref: '#/components/schemas/CashAccount16' InstdRmbrsmntAgtAcct: type: object description: Unambiguous identification of the account of the instructed reimbursement agent account at its servicing agent in the payment chain. allOf: - $ref: '#/components/schemas/CashAccount16' ThrdRmbrsmntAgtAcct: type: object description: Unambiguous identification of the account of the third reimbursement agent account at its servicing agent in the payment chain. allOf: - $ref: '#/components/schemas/CashAccount16' InstgRmbrsmntAgt: type: object description: Agent through which the instructing agent will reimburse the instructed agent. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' InstdRmbrsmntAgt: type: object description: Agent at which the instructed agent will be reimbursed. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' ThrdRmbrsmntAgt: type: object description: Agent at which the instructed agent will be reimbursed. allOf: - $ref: '#/components/schemas/BranchAndFinancialInstitutionIdentification4' ClrSys: $ref: '#/components/schemas/ClearingSystemIdentification3Choice' description: Specifies the details on how the settlement of the original transaction(s) between the instructing agent and the instructed agent was completed. ValidationRequest: required: - paymentBase64 type: object properties: paymentBase64: type: string description: 'paymentBase64: ISO XML V3 (pain.001.001.03) file has to be converted to Base64 format and passed in tags. Based on the use case, you should use one of the ISO schema. Use PACS schema for financial institutions and PAIN format for non-financial clients. ISO schema can be refered from below URL pain.001.001.03 - https://www.iso20022.org/message/14316/download or #/definitions/Pain001 ' example: PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxEb2N1bWVudCB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIiB4bWxucz0idXJuOmlzbzpzdGQ6aXNvOjIwMDIyOnRlY2g6eHNkOnBhaW4uMDAxLjAwMS4wMyI+DQogIDxDc3RtckNkdFRyZkluaXRuPg0KICAgIDxHcnBIZHI+DQogICAgICA8TXNnSWQ+R0JQMTYxMTE0Njk0ODY5PC9Nc2dJZD4NCiAgICAgIDxDcmVEdFRtPjIwMTctMDYtMDJUMTA6MTc6NTU8L0NyZUR0VG0+DQogICAgICA8TmJPZlR4cz4xPC9OYk9mVHhzPg0KICAgICAgPEN0cmxTdW0+MS4wMDwvQ3RybFN1bT4NCiAgICAgIDxJbml0Z1B0eT4NCiAgICAgICAgPE5tPkh1ZHNvbiBBZHZpc29ycyBFdXJvcGUgTHRkPC9ObT4NCiAgICAgIDwvSW5pdGdQdHk+DQogICAgPC9HcnBIZHI+DQogICAgPFBtdEluZj4NCiAgICAgIDxQbXRJbmZJZD4xNDAxNzQ5OCBGdW5kIFRyYW5zZmVyIERvbWVzdGljPC9QbXRJbmZJZD4NCiAgICAgIDxQbXRNdGQ+VFJGPC9QbXRNdGQ+DQogICAgICA8TmJPZlR4cz4xPC9OYk9mVHhzPg0KICAgICAgPEN0cmxTdW0+MS4wMDwvQ3RybFN1bT4NCiAgICAgIDxQbXRUcEluZj4NCiAgICAgICAgPFN2Y0x2bD4NCiAgICAgICAgICA8Q2Q+VVJHUDwvQ2Q+DQogICAgICAgIDwvU3ZjTHZsPg0KICAgICAgPC9QbXRUcEluZj4NCiAgICAgIDxSZXFkRXhjdG5EdD4yMDE5LTA4LTIwPC9SZXFkRXhjdG5EdD4NCiAgICAgIDxEYnRyPg0KICAgICAgICA8Tm0+Q0lUSUJBTksgRS1CVVNJTkVTUyBFVVIgRFVNIERFTU88L05tPg0KICAgICAgICA8UHN0bEFkcj4NCiAgICAgICAgICA8Q3RyeT5HQjwvQ3RyeT4NCiAgICAgICAgPC9Qc3RsQWRyPg0KICAgICAgICA8SWQ+DQogICAgICAgICAgPE9yZ0lkPg0KICAgICAgICAgICAgPEJJQ09yQkVJPkNJVElHQjJMPC9CSUNPckJFST4NCiAgICAgICAgICA8L09yZ0lkPg0KICAgICAgICA8L0lkPg0KICAgICAgPC9EYnRyPg0KICAgICAgPERidHJBY2N0Pg0KICAgICAgICA8SWQ+DQogICAgICAgICAgPE90aHI+DQogICAgICAgICAgICA8SWQ+MTAwMTIyNjI8L0lkPg0KICAgICAgICAgIDwvT3Rocj4NCiAgICAgICAgPC9JZD4NCiAgICAgICAgPENjeT5VU0Q8L0NjeT4NCiAgICAgIDwvRGJ0ckFjY3Q+DQogICAgICA8RGJ0ckFndD4NCiAgICAgICAgPEZpbkluc3RuSWQ+DQogICAgICAgICAgPEJJQz5DSVRJR0IyTDwvQklDPg0KICAgICAgICAgIDxQc3RsQWRyPg0KICAgICAgICAgICAgPEN0cnk+R0I8L0N0cnk+DQogICAgICAgICAgPC9Qc3RsQWRyPg0KICAgICAgICA8L0Zpbkluc3RuSWQ+DQogICAgICA8L0RidHJBZ3Q+DQogICAgICA8Q2hyZ0JyPkRFQlQ8L0NocmdCcj4NCiAgICAgIDxDZHRUcmZUeEluZj4NCiAgICAgICAgPFBtdElkPg0KICAgICAgICAgIDxFbmRUb0VuZElkPlBBMjAxODIwMTkxMjwvRW5kVG9FbmRJZD4NCiAgICAgICAgPC9QbXRJZD4NCiAgICAgICAgPEFtdD4NCiAgICAgICAgICA8SW5zdGRBbXQgQ2N5PSJVU0QiPjEuMDA8L0luc3RkQW10Pg0KICAgICAgICA8L0FtdD4NCiAgICAgICAgPFVsdG10RGJ0cj4NCiAgICAgICAgICA8SWQ+DQogICAgICAgICAgICA8UHJ2dElkPg0KICAgICAgICAgICAgICA8T3Rocj4NCiAgICAgICAgICAgICAgICA8SWQ+UEFSVElDSVBBTlQgSUQgUE9CTyBVSyBCUjYwMCAwMTIzNDU8L0lkPg0KICAgICAgICAgICAgICAgIDxTY2htZU5tPg0KICAgICAgICAgICAgICAgICAgPFBydHJ5PklOU1Q8L1BydHJ5Pg0KICAgICAgICAgICAgICAgIDwvU2NobWVObT4NCiAgICAgICAgICAgICAgPC9PdGhyPg0KICAgICAgICAgICAgPC9QcnZ0SWQ+DQogICAgICAgICAgPC9JZD4NCiAgICAgICAgPC9VbHRtdERidHI+DQogICAgICAgIDxDZHRyQWd0Pg0KICAgICAgICAgIDxGaW5JbnN0bklkPg0KICAgICAgICAgICAgPEJJQz5DSVRJR0IyTDwvQklDPg0KICAgICAgICAgICAgPENsclN5c01tYklkPg0KICAgICAgICAgICAgICA8TW1iSWQ+MTg1MDA4PC9NbWJJZD4NCiAgICAgICAgICAgIDwvQ2xyU3lzTW1iSWQ+DQogICAgICAgICAgICA8Tm0+Q0lUSUJBTksoSVNPKTwvTm0+DQogICAgICAgICAgICA8UHN0bEFkcj4NCiAgICAgICAgICAgICAgPEN0cnk+R0I8L0N0cnk+DQogICAgICAgICAgICA8L1BzdGxBZHI+DQogICAgICAgICAgPC9GaW5JbnN0bklkPg0KICAgICAgICA8L0NkdHJBZ3Q+DQogICAgICAgIDxDZHRyPg0KICAgICAgICAgIDxObT44MDEwNjQzMTIyWCBYWFhYWFhYWFhYWFhYIFhYWDwvTm0+DQogICAgICAgICAgPFBzdGxBZHI+DQogICAgICAgICAgICA8Q3RyeT5HQjwvQ3RyeT4NCiAgICAgICAgICA8L1BzdGxBZHI+DQogICAgICAgICAgPEN0Y3REdGxzPg0KICAgICAgICAgICAgPE5tPldEVyAzIElOVkVTVE1FTlRTIExJTUlURUQ8L05tPg0KICAgICAgICAgIDwvQ3RjdER0bHM+DQogICAgICAgIDwvQ2R0cj4NCiAgICAgICAgPENkdHJBY2N0Pg0KICAgICAgICAgIDxJZD4NCiAgICAgICAgICA8T3Rocj4NCiAgICAgICAgICAgICAgICAgICA8SWQ+MTAwMTIyNjI8L0lkPg0KICAgICAgICAgICAgICAgICAgPC9PdGhyPg0KICAgICAgICAgIDwvSWQ+DQogICAgICAgIDwvQ2R0ckFjY3Q+DQogICAgICAgIDxSbXRJbmY+DQogICAgICAgICAgPFVzdHJkPlRSMDAyNjM4PC9Vc3RyZD4NCiAgICAgICAgPC9SbXRJbmY+DQogICAgICA8L0NkdFRyZlR4SW5mPg0KICAgIDwvUG10SW5mPg0KICA8L0NzdG1yQ2R0VHJmSW5pdG4+DQo8L0RvY3VtZW50Pg== description: Object representing payment initiation request. ISO schema can be found at https://www.iso20022.org/catalogue-messages/iso-20022-messages-archive?page=4 and select Payments Initiation V03 and Payments Clearing and Settlement V09 then select more and download mdr file for detailed information on schema and xsd schema definitions. xml: name: Request CustomerPaymentStatusReportV03: required: - GrpHdr - OrgnlGrpInfAndSts type: object properties: GrpHdr: $ref: '#/components/schemas/GroupHeader36' OrgnlGrpInfAndSts: $ref: '#/components/schemas/OriginalGroupInformation20' OrgnlPmtInfAndSts: type: array description: Information concerning the original payment information, to which the status report message refers. items: $ref: '#/components/schemas/OriginalPaymentInformation1' Max35Text: maxLength: 35 minLength: 1 type: string paymentStatusInquiryResponse: type: string description: 'Base64 encoded string of ISO XML the response follows ISOXML urn:iso:std:iso:20022:tech:xsd:pain.002.001.03 https://www.iso20022.org/message/14361/download or #/definitions/Pain002' format: byte example: PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxEb2N1bWVudCB4bWxucz0idXJuOmlzbzpzdGQ6aXNvOjIwMDIyOnRlY2g6eHNkOnBhaW4uMDAyLjAwMS4wMyI+DQoJPENzdG1yUG10U3RzUnB0Pg0KCQk8R3JwSGRyPg0KCQkJPE1zZ0lkPkNJVElCQU5LLzIwMTkxMjExLVBTUi85NDE0MTYxNzc8L01zZ0lkPg0KCQkJPENyZUR0VG0+MjAxOS0xMi0xMVQwNjoyNDo1MjwvQ3JlRHRUbT4NCgkJCTxJbml0Z1B0eT4NCgkJCQk8SWQ+DQoJCQkJCTxPcmdJZD48QklDT3JCRUk+Q0lUSVVTMzM8L0JJQ09yQkVJPjwvT3JnSWQ+DQoJCQkJPC9JZD4NCgkJCTwvSW5pdGdQdHk+DQoJCTwvR3JwSGRyPg0KCQk8T3JnbmxHcnBJbmZBbmRTdHM+DQoJCQk8T3JnbmxNc2dJZD5Nc2dJZGZmZ2g8L09yZ25sTXNnSWQ+DQoJCQk8T3JnbmxNc2dObUlkPnBhaW4uMDA3LjAwMS4wOTwvT3JnbmxNc2dObUlkPg0KCQkJPE9yZ25sQ3JlRHRUbT4yMDE5LTEyLTExVDEyOjAwOjAwPC9PcmdubENyZUR0VG0+DQoJCQk8T3JnbmxOYk9mVHhzPjE8L09yZ25sTmJPZlR4cz4NCgkJPC9PcmdubEdycEluZkFuZFN0cz4NCgkJPE9yZ25sUG10SW5mQW5kU3RzPg0KCQkJPE9yZ25sUG10SW5mSWQ+NDU2ODc5NjwvT3JnbmxQbXRJbmZJZD4NCgkJCTxUeEluZkFuZFN0cz4NCgkJCQk8T3JnbmxFbmRUb0VuZElkPjIwMTkxMjA5Q0lUSVNHUzBCUlQyMTAxNjMwPC9PcmdubEVuZFRvRW5kSWQ+DQoJCQkJPFR4U3RzPkFDVEM8L1R4U3RzPg0KCQkJPC9UeEluZkFuZFN0cz4NCgkJPC9PcmdubFBtdEluZkFuZFN0cz4NCgk8L0NzdG1yUG10U3RzUnB0Pg0KPC9Eb2N1bWVudD4= xml: name: paymentStatusInquiryResponse Max2048Text: maxLength: 2048 minLength: 1 type: string ServiceLevel8Choice: type: object properties: Cd: maxLength: 4 minLength: 1 type: string description: Specifies the external service level code in the format of character string with a maximum length of 4 characters.The list of valid codes is an external code list published separately. Prtry: type: object description: Specifies a pre-agreed service or level of service between the parties, as a proprietary code. allOf: - $ref: '#/components/schemas/Max35Text' description: Agreement under which or rules under which the transaction should be processed. Either code or proprietary field values should be sent in request. Max4Text: maxLength: 4 minLength: 1 type: string CashAccountType2: type: object properties: Cd: $ref: '#/components/schemas/CashAccountType4Code' Prtry: type: object description: Nature or use of the account in a proprietary form. allOf: - $ref: '#/components/schemas/Max35Text' description: Specifies the nature, or use of the account. Either Code or Proprietary field value should be passed on request. ActiveOrHistoricCurrencyAndAmount_SimpleType: maxLength: 18 type: string description: 'The number of fractional digits (or minor unit of currency) must comply with ISO 4217. Note: The decimal separator is a dot.A number of monetary units specified in an active or a historic currency where the unit of currency is explicit and compliant with ISO 4217. The number of fractional digits should be 5.' CashAccount16: required: - Id type: object properties: Ccy: type: object description: Identification of the currency in which the account is held. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyCode' Id: $ref: '#/components/schemas/AccountIdentification4Choice' Nm: type: object description: Name of the account, as assigned by the account servicing institution, in agreement with the account owner in order to provide an additional means of identification of the account. allOf: - $ref: '#/components/schemas/Max70Text' Tp: $ref: '#/components/schemas/CashAccountType2' PaymentInquiryRequest: required: - EndToEndId - WLClientID type: object properties: EndToEndId: maxLength: 35 pattern: '[a-zA-Z0-9_]*' type: string description: Unique identification assigned by the initiating party to clearly identify the transaction. This Identification is passed on, unchanged, throughout the entire end-to-end chain. example: API_2WAY_WIRE_01 WLClientID: maxLength: 35 pattern: '[a-zA-Z0-9]*' type: string description: Client ID to uniquely identify the transaction along with transaction reference number. example: '000000001' WLRef: maxLength: 12 pattern: '[a-zA-Z0-9]*' type: string description: WorldLink generated unique reference number received in WorldLink Payment Initiation response example: KH80FI20GBY4 CreDtTm: type: string description: Date when the payment initiation started. The date format is YYYY-MM-DD. format: date example: '2020-09-12' ReqdExctnDt: type: string description: The date that the initiating party requests that the clearing agent process the payment. format: date example: '2017-09-05' InstdAmt: type: object description: This represents the amount of money transferred between the debtor and the creditor before any deduction of charges is made. This is expressed in the currency that is specified by the initiating party. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmountStatusInquiry' EqvtAmt: required: - Amt - CcyOfTrf type: object properties: Amt: type: object description: Amount of money allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyAndAmountStatusInquiry' CcyOfTrf: type: object description: Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account. allOf: - $ref: '#/components/schemas/ActiveOrHistoricCurrencyCode' description: Partner can send either Payment Amount or Equivalent Amount and not both description: Payment Status Inquiries Inputs disclosure_response: type: object properties: out: required: - deliveryDate - disclosureDate - feeType - otherFees - returnCode - returnMessage - totalTaxes - uniqueIdentifier type: object properties: disclosureDate: type: string description: The disclosure date. Format => Timestamp > yyyy-mm-dd hh:mm:ss[.fffffffff]. otherFees: type: number description: Sum of all fees calculated, including bene deduct. Between 0.00 and 9999999999999999.999 feeType: maxLength: 1 type: string description: Fee description Actual(A) or Estimate(E). enum: - A - E totalTaxes: type: number description: Sum of all taxes calculated. Between 0.00 and 9999999999999999.999. deliveryDate: type: string description: The calculated delivery date for payment. Format => Timestamp > yyyy-mm-dd hh:mm:ss[.fffffffff]. uniqueIdentifier: maxLength: 15 type: string description: API Packet identifier. returnCode: maxLength: 5 type: string description: Code to show if API worked. returnMessage: maxLength: 100 type: string description: Descriptive message to show if API passed, or the reason for the failure. chargeCodeUsed: maxLength: 3 type: string description: Charge code calculated by Dodd-Frank application based on its rules. beneDeductUsed: maxLength: 1 type: string description: Bene deduct fee indicator passed in input request field isBeneDeduct. beneDeductFeeTypeUsed: maxLength: 1 type: string description: Bene deduct fee type passed in input request field beneDeductFeeType. example: disclosureDate: '2019-25-04T08:13:21.123-05:00' otherFees: 25 feeType: E totalTaxes: 2 deliveryDate: '2019-25-04T08:13:21.123-05:00' uniqueIdentifier: 000000000810814 returnCode: '0' returnMessage: SUCCESS chargeCodeUsed: BEN examples: Payment-Status-Inquiry-Response-Json: value: FxGetDealOperationResponse: FXP588INOperationResponse: FxDealInquiryRsp: Source: APIM WLClntId: '629550001' ContractRef: M16463100879607 UserId: XBACBC4 ResTime: 2026-04-07-07:39:20 PymtCcy: CAD PymtCcyAmt: '145.00' FundCcy: EUR FundCcyAmt: '90.04' Symbol: CADEUR Rate: '0.62100000' BookDate: '20251024' ValueDate: '20251027' DealTs: 2025-10-24-04.02.26.701438 FundActTotalLmt: '90.04' FundActAvlLmt: '90.04' FundActEarMrkLmt: '0.00' FundActUtilLmt: '0.00' PymtActTotalLmt: '145.00' PymtActAvlLmt: '145.00' PymtActEarMrkLmt: '0.00' PymtActUtilLmt: '0.00' StatusCode: '000' StatusMsg: '000: Requested deal found' Payment-Validation-Response-Json: value: '@xmlns': urn:iso:std:iso:20022:tech:xsd:pain.002.001.03 customer_payment_status_report: group_header: message_identification: Wire_SZD_API_1401 creation_date_time: '2020-02-20T09:30:47' initiating_party: name: MSA ILE DE FRANCE postal_address: address_type: ADDR department: Dept001 sub_department: Subdept001 street_name: street name01 building_number: '113232370123456' post_code: '7777777' town_name: townname1townname1townna country_sub_division: subdivctry01 country: GB identification: organisation_identification: other: - identification: '248840001' country_of_residence: TR contact_details: name: Client5 original_group_information_and_status: original_message_identification: Wire_SZD_API_1401 original_message_name_identification: Pain.001.001.03 original_creation_date_time: '2020-02-20T09:30:47' original_number_of_transactions: '1' original_control_sum: '200' original_payment_information_and_status: - original_payment_information_identification: Wire_SZD_FD_API_1401 transaction_information_and_status: - original_instruction_identification: JA2020072235 original_end_to_end_identification: JA2020072235 transaction_status: RJCT status_reason_information: - additional_information: - Target Account Number IBAN: Field'Target_Account_Number_IBAN' is mandatory. original_transaction_reference: amount: instructed_amount: currency: EUR $: '200' requested_execution_date: '2020-07-22' payment_type_information: service_level: code: URGP category_purpose: code: OTHR payment_method: TRF remittance_information: unstructured: - '12796190145799300' debtor: name: MSA ILE DE FRANCE postal_address: address_type: ADDR department: Dept001 street_name: street name01 building_number: '113232370123456' post_code: '7777777' town_name: townname1 country_sub_division: subdivctry01 country: SZ debtor_account: identification: other: identification: '789652' currency: CAD debtor_agent: financial_institution_identification: bic: CITICA5AXXX other: identification: '248840001' creditor_agent: financial_institution_identification: bic: SOGEADPPXXX name: Bene Bank Name postal_address: street_name: Wellsprings Renaissanc building_number: Building No 02 post_code: '71492' town_name: Newtownships country: AD creditor: name: Rehan postal_address: address_type: HOME street_name: Mumbai building_number: '113232123456' country: AD creditor_account: identification: other: identification: '14258632545' Payment-Validation-Request-Json: value: '@xmlns': urn:iso:std:iso:20022:tech:xsd:pain.001.001.03 customer_credit_transfer_initiation: group_header: message_identification: Wire_SZD_API_1401 creation_date_time: '2020-02-20T09:30:47' number_of_transactions: '1' control_sum: '200' initiating_party: name: MSA ILE DE FRANCE postal_address: address_type: ADDR department: Dept001 sub_department: Subdept001 street_name: street name01 building_number: '113232370123456' post_code: '7777777' town_name: townname1townname1townna country_sub_division: subdivctry01 country: GB identification: organisation_identification: other: - identification: '248840001' country_of_residence: TR contact_details: name: Client5 payment_information: - payment_information_identification: Wire_SZD_FD_API_1401 payment_method: TRF requested_execution_date: '2020-07-22' debtor: name: MSA ILE DE FRANCE postal_address: address_type: ADDR department: Dept001 street_name: street name01 building_number: '113232370123456' post_code: '7777777' town_name: townname1 country_sub_division: subdivctry01 country: SZ debtor_account: identification: other: identification: '789652' currency: CAD debtor_agent: financial_institution_identification: bic: CITICA5AXXX other: identification: '248840001' credit_transfer_transaction_information: - payment_identification: instruction_identification: JA2020072233 end_to_end_identification: JA2020072233 payment_type_information: service_level: code: URGP category_purpose: code: OTHR amount: instructed_amount: currency: EUR $: '200' charge_bearer: SHAR creditor_agent: financial_institution_identification: bic: SOGEADPPXXX name: Bene Bank Name postal_address: street_name: Wellsprings Renaissanc building_number: Building No 02 post_code: '71492' town_name: Newtownships country: AD creditor: name: Rehan postal_address: address_type: HOME street_name: Mumbai building_number: '113232123456' country: AD creditor_account: identification: iban: AD1200012030200359100100 remittance_information: unstructured: - '12796190145799300' securitySchemes: clientCredentials: description: 'All CitiConnect APIs use the oAuth2 authentication scheme, which requires a bearer token to authenticate your API call. The Token URL includes the version of authentication used by this API. See the Citi Authentication API reference for information on requesting a token. ' type: oauth2 flows: clientCredentials: tokenUrl: /authenticationservices/v3/oauth/token scopes: {}