Skip to content

New payment form

The New payment form allows you to initiate remittance payments and treasury transactions in Ripple Payments UI.

New payment form

Payment fields

The new payment form contains the following required fields:

FieldDefinition
Quote TypeThe stage in the payment chain where the amount specified in the Amount field applies. Amounts in stages before and after the specified stage may differ after fees are applied.
The options include:
  • Sending Amount: the amount to be sent prior to factoring in the FX and cost.
  • Receiving Amount: the amount to be received after FX and fees have been applied.
AmountThe amount of payment in the stage and currency specified by the Quote Type and Payment Currency fields.
Payment CurrencyThe type of currency used to define the payment amount set in the Amount field.
Receiver CountryThe country in which the receiver of the payment is located.
Payout CurrencyType of currency in which the receiver specified in the Receiver Country field will be paid out.

Get Quote button

The Get Quote button submits the payment quote request defined by the fields in the New Payment form. RippleNet returns a set of one or more quotes that show available payment options that include applicable fees and exchange rates.

Advanced options

Advanced options are optional fields that can define a quote request beyond the basic payment parameters.

Advanced options fields

FieldDescription
Receiver RippleNet AccountThe RippleNet account name of your receiving partner’s account used to receive this payment. You can get this account name from your receiving partner.
Sender Segregated AccountThe RippleNet account name of a receiving partner account that belongs to you (a nostro account). This account is used to send the payment.
Sender or Receiver Currency(Fiat only) Filter all returned quotes to show only quotes that use the type of currency specified in the basic “Payment Currency” field. The filter is applied to the party specified in the “Quote Type” field.
Custom RateThe ratio of the base currency to the counter currency.
Rate TypeDetermines which currency is the base currency and which is the counter currency when specifying the Rate value. The dropdown offers two choices:
  • Buyer: the sent currency is the base currency; the received currency is the counter currency.
  • Seller: the receiver currency is the base currency; the sent currency is the counter currency.
Base CurrencyThe type of currency used as the base currency. The value must be a three-letter standard international country currency code.
Counter CurrencyThe type of currency used as the counter currency. The value must be a three-letter standard international country currency code.
Custom FeeThe fee that you’d like applied at the first stage of the payment’s progress through intermediate instances. The fee value is the amount of fee you want to apply using the currency defined for the sender institution. This value overrides sending fees configured in your institution’s instance.
Force path finding & liquidity path findingWhen checked, Ripple Payments UI disregards cached paths for this quote request so that RippleNet will find one or more new possible paths for payment.
Quote RouteFilter returned quotes to show only those that use at least one of the intermediary institutions listed here. Accepts a set of one or more RippleNet addresses separated by commas.

Quote review form

Ripple Payments UI displays the payment quote from the receiver to review and accept.

New payment quote review

Select a beneficiary

This part of the quote review form provides fields that you need to fill in to specify the final payout beneficiary.

FieldDefinition
Saved BeneficiaryName of the final payout beneficiary.
Transaction PurposePurpose of the transaction.
Source of FundsSource where the funds for completing this transaction come from.

If you want to make the payment on behalf of someone else, select This payment will be made on behalf of a separate originator and in the Saved Originator field, specify the name of the payment originator.

Tip

If you don't see the intended beneficiary (or originator) for this payment in the respective drop-down list, most likely you haven't used that payment participant before, hence, you need to add them first. Select Add Identity in the Ripple Payments UI and see Beneficiaries and Originator management for more information.

In the optional Internal ID field, you can assign a unique ID to a transaction for internal communication and tracking.

Accept quote and Back buttons

  • Select the Accept quote button to accept the quote.
  • Select the Back button to go back to the new payment quote page.