--- title: "Initiate Last Domestic Leg Payout" method: POST path: "/wallet_accounts/{id}/npp_last_domestic_leg" tags: ["Wallet Accounts"] --- # Initiate Last Domestic Leg Payout `POST /wallet_accounts/{id}/npp_last_domestic_leg` Facilitate the real-time settlement of the last domestic leg payout for International Funds Transfer Instructions (IFTI) through NPP rails. ## Path parameters - `id` string, required ## Request body - NppLastDomesticLegRequestBody - `account_id` string, required — Account to withdraw to. - `amount` integer, required — Amount (in cents) to withdraw. - `custom_descriptor` string — A descriptor specified by the customer to be passed on the withdraw call. This requires that custom_descriptors are enabled. In the case of fast payments (AU / NPP) Assembly will append a value in the beginning of descriptor, the customer can use 200 characters (excluding URL, javascript/code, emojis). In the case of DE batch payments will allow 18 characters - `reference_id` string — Unique reference information that can be specified for a for wallet withdrawal request. This is an optional field and cannot contain '.' character. - `end_to_end_id` string, required — A unique identifier assigned by the initiating party to track and reconcile the IFTI payout throughout its lifecycle. This value must be unique per transaction and is included in payment messaging for traceability across participating financial institutions. This is the Debtor’s (customer) reference for the Payment to be provided to Creditor (customer). Mandatory for NPP IFTI Payment. - `ifti_information` object, required — IFTI Payer Information. This is a required field and cannot contain invalid characters. Please get in touch with customer service before enabling this feature. Fields marked below are required exclusively for **IFTI payout processing to meet reporting and compliance requirements**. Please refer to individual field descriptions for specific conditional requirements - `instruction_identification` string, required — A unique transaction reference number that identifies the final domestic payout request for NPP. It is recommended that this reference number matches the point-to-point transaction reference used in your Austrac reporting. Mandatory for NPP IFTI Payment. - `ultimate_debtor_information` object, required — Following fields are mandatory. **name, address.country_code, address.address_line, country_of_residence**. Fields from these two groups must not be mixed. Either (organisation_identification or organisation_identification and organisation_bic) or (private_identification, or private_identification and date_place_of_birth) **must be present**. - `name` string - `address` IftiAddress — This represents address of an individual or non-individual customer of a NPP participant. This object could be populated in one of formats below: - `address_type` 'ADDR' | 'BIZZ' | 'DLVY' | 'HOME' | 'MLTO' | 'PBOX' — Address Type ADDR - Postal Address is the complete postal address BIZZ - Business Address is the business address DLVY - Delivery To Address is the address to which delivery is to take place HOME - Residential Address is the home address MLTO - Mail To Address is the address to which mail is sent PBOX - POBox Address is a postal office (PO) box - `department` string — Department - `sub_department` string — Sub Department - `street_name` string — Street Name - `bldg_name` string — Building name - `postcode` string — Post Code - `town_name` string — Town name - `ctry_sub_division` string — Country Subdivision - `country_code` string — Country Code - `address_line` string[] — Address Lines: "address_line": ["Melbourne", "2000" ] - `organisation_identification` GenericIdentification[] - `identification` string, required - `identification_type_proprietary` string - `identification_type_code` string - `identification_issuer` string - `organisation_bic` string - `private_identification` GenericIdentification[] - `identification` string, required - `identification_type_proprietary` string - `identification_type_code` string - `identification_issuer` string - `date_place_of_birth` DateAndPlaceOfBirth - `birth_date` string, date, required - `place_of_birth` string - `city_of_birth` string, required - `country_of_birth` string, required - `country_of_residence` string - `contact_details` ContactDetails - `name_prefix` 'DOCT' | 'MIST' | 'MISS' | 'MADM' - `name` string - `phone_number` string - `mobile_number` string - `fax_number` string - `email_address` string - `other` string - `charge_bearer` 'CRED' | 'DEBT' | 'SHAR', required — Specifies which party/parties will bear the charges of processing payment transaction. Valid values - 'CRED' (Borne by Creditor), 'DEBT' (Borne by Debtor), 'SHAR' (Shared). - `previous_instructing_agent` object, required — This identifies the agent or remitter's bank that instructs the intermediary bank or NPP payer participant to clear funds, typically for bulk or aggregated transfers to your account. This can either be the agent_bic OR clearing system identification and clearing system member identification. - `agent_bic` string - `clearing_system_identification` string - `clearing_system_member_identification` string - `creditor_agent_instruction` object[], required — Refers to additional details or instructions provided to the bank or financial institution responsible for crediting the funds to the recipient (the creditor). These instructions are provided by the initiating party and help the creditor agent accurately complete the transfer. - `instruction_information` string — We recommend providing the Originating Debtor Agent BIC as indicated in the initial message, which received the international pay-in instruction from the initiating party. - `code` string - `initiating_party_information` object, required — Following fields are mandatory. **name, address.country_code, address.address_line, country_of_residence**. Fields from these two groups must not be mixed. Either (organisation_identification or organisation_identification and organisation_bic) or (private_identification, or private_identification and date_place_of_birth) **must be present**. - `name` string - `address` IftiAddress — This represents address of an individual or non-individual customer of a NPP participant. This object could be populated in one of formats below: - `address_type` 'ADDR' | 'BIZZ' | 'DLVY' | 'HOME' | 'MLTO' | 'PBOX' — Address Type ADDR - Postal Address is the complete postal address BIZZ - Business Address is the business address DLVY - Delivery To Address is the address to which delivery is to take place HOME - Residential Address is the home address MLTO - Mail To Address is the address to which mail is sent PBOX - POBox Address is a postal office (PO) box - `department` string — Department - `sub_department` string — Sub Department - `street_name` string — Street Name - `bldg_name` string — Building name - `postcode` string — Post Code - `town_name` string — Town name - `ctry_sub_division` string — Country Subdivision - `country_code` string — Country Code - `address_line` string[] — Address Lines: "address_line": ["Melbourne", "2000" ] - `organisation_identification` GenericIdentification[] - `identification` string, required - `identification_type_proprietary` string - `identification_type_code` string - `identification_issuer` string - `organisation_bic` string - `private_identification` GenericIdentification[] - `identification` string, required - `identification_type_proprietary` string - `identification_type_code` string - `identification_issuer` string - `date_place_of_birth` DateAndPlaceOfBirth - `birth_date` string, date, required - `place_of_birth` string - `city_of_birth` string, required - `country_of_birth` string, required - `country_of_residence` string - `contact_details` ContactDetails - `name_prefix` 'DOCT' | 'MIST' | 'MISS' | 'MADM' - `name` string - `phone_number` string - `mobile_number` string - `fax_number` string - `email_address` string - `other` string - `ultimate_creditor_information` object — The name of the final recipient of the funds, not including any intermediaries or account holders. Mandatory for IFTI if present in the source international message." - `name` string - `address` IftiAddress — This represents address of an individual or non-individual customer of a NPP participant. This object could be populated in one of formats below: - `address_type` 'ADDR' | 'BIZZ' | 'DLVY' | 'HOME' | 'MLTO' | 'PBOX' — Address Type ADDR - Postal Address is the complete postal address BIZZ - Business Address is the business address DLVY - Delivery To Address is the address to which delivery is to take place HOME - Residential Address is the home address MLTO - Mail To Address is the address to which mail is sent PBOX - POBox Address is a postal office (PO) box - `department` string — Department - `sub_department` string — Sub Department - `street_name` string — Street Name - `bldg_name` string — Building name - `postcode` string — Post Code - `town_name` string — Town name - `ctry_sub_division` string — Country Subdivision - `country_code` string — Country Code - `address_line` string[] — Address Lines: "address_line": ["Melbourne", "2000" ] - `organisation_identification` GenericIdentification[] - `identification` string, required - `identification_type_proprietary` string - `identification_type_code` string - `identification_issuer` string - `organisation_bic` string - `private_identification` GenericIdentification[] - `identification` string, required - `identification_type_proprietary` string - `identification_type_code` string - `identification_issuer` string - `date_place_of_birth` DateAndPlaceOfBirth - `birth_date` string, date, required - `place_of_birth` string - `city_of_birth` string, required - `country_of_birth` string, required - `country_of_residence` string - `contact_details` ContactDetails - `name_prefix` 'DOCT' | 'MIST' | 'MISS' | 'MADM' - `name` string - `phone_number` string - `mobile_number` string - `fax_number` string - `email_address` string - `other` string - `instructed_amount` object — Transaction Amount. This is the amount originated in foreign currency. - `currency` string - `amount` string - `exchange_rate` string — Exchange rate used for AUD FX conversion. Mandatory for IFTI if present in the source international message. - `payment_purpose_proprietary` string — Refers to a code or description used to specify the reason or purpose for the payment. This information is often provided by the sender to clarify the intent of the transfer, such as payment for goods, services, or a personal remittance. Mandatory for IFTI if present in the source international message. - `payment_information` object — Mandatory for IFTI if present in the source international message. - `remittance_information_unstructured` string — Refers to additional, free-text details provided by the sender about the purpose or context of the payment. - `payment_purpose_code` string — This refers to the standardized code that indicates the reason for the payment. It helps to identify the nature of the transaction for regulatory and compliance purposes. Refer to https://www.iso20022.org/catalogue-messages/additional-content-messages/external-code-sets for full list of Payment Purpose code. - `regulatory_reporting` object[] — Refers to the obligation to report certain transaction details to regulatory authorities to comply with anti-money laundering (AML), counter-terrorism financing (CTF), and other financial regulations. - `authority_name` string — Refers to the name of the regulatory body or financial authority to which the payment details are reported for compliance purposes. This is typically a government or financial intelligence agency that monitors transactions for anti-money laundering (AML) and counter-terrorism financing (CTF) efforts. - `remittance_information_structured` object — It is any additional information or directions provided by the offshore debtor to the creditor in relation to the instruction should be forwarded in this field. - `referred_document_amount` object — Transaction Amount - `due_payable_amount` object - `currency` string - `amount` string - `related_remittance_information` object[] - `identification` string ## Response `201` OK - object - `disbursements` NppLastDomesticLegDisbursement - `id` string - `reference_id` string - `amount` integer - `currency` string - `batch_id` string - `cuscal_payment_transaction_id` string - `created_at` string, date-time - `updated_at` string, date-time - `state` string - `to` string - `bank_name` string - `bank_account_name` string - `bank_account_number` string - `bank_routing_number` string - `npp_payout_state` string - `account_name` string - `biller_name` string - `biller_code` string - `crn` string - `links` object - `transactions` string - `wallet_accounts` string - `paypal_accounts` string - `bank_accounts` string - `bpay_accounts` string - `items` string - `users` string - `end_to_end_id` string - `ifti_information` IftiInformationResponse - `instruction_identification` string - `ultimate_debtor_information` object - `name` string - `country_of_residence` string - `address` object - `country_code` string - `address_line` unknown[] - unknown - `organisation_identification` object[] - `identification` string - `charge_bearer` string - `previous_instructing_agent` object - `agent_bic` string - `creditor_agent_instruction` object - `instruction_information` string - `code` string - `initiating_party_information` object - `name` string - `country_of_residence` string - `address` object - `country_code` string - `address_line` unknown[] - unknown - `organisation_identification` object[] - `identification` string - `instructed_amount` object - `currency` string - `amount` string - `ultimate_creditor_information` object - `name` string - `country_of_residence` string - `address` object - `country_code` string - `address_line` unknown[] - unknown - `organisation_identification` object[] - `identification` string - `exchange_rate` string - `payment_purpose_proprietary` string - `payment_information` object - `remittance_information_unstructured` string - `payment_purpose_code` string - `regulatory_reporting` object[] - `authority_name` string - `remittance_information_structured` object - `referred_document_amount` object - `due_payable_amount` object - `currency` string - `amount` string - `related_remittance_information` object[] - `identification` string --- [API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/versions/60b528b2e015/schema)