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:

Field Definition
Quote Type The 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.
Amount The amount of payment in the stage and currency specified by the Quote Type and Payment Currency fields.
Payment Currency The type of currency used to define the payment amount set in the Amount field.
Receiver Country The country in which the receiver of the payment is located.
Payout Currency Type 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

Field Description
Receiver RippleNet Account The 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 Account The 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 Rate The ratio of the base currency to the counter currency.
Rate Type Determines 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 Currency The type of currency used as the base currency. The value must be a three-letter standard international country currency code.
Counter Currency The type of currency used as the counter currency. The value must be a three-letter standard international country currency code.
Custom Fee The 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 finding When 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 Route Filter 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.

Field Definition
Saved Beneficiary Name of the final payout beneficiary.
Transaction Purpose Purpose of the transaction.
Source of Funds Source where the funds for completing this transaction come from.
Tip

If you don't see the intended beneficiary for this payment in the Saved Beneficiary drop-down list, most likely you haven't sent a payment to this beneficiary before, hence, you need to add the beneficiary first. Click Add beneficiary in the Ripple Payments UI and see Identity management for more information.

Optional identifiers

This part of the quote review form provides optional fields that you can fill in to include with your quote acceptance.

Field Definition
End-to-End ID A unique, user-assigned ID assigned to a transaction and shared between sender, receiver, and any intermediaries, which persists even if the payment ID for a transaction changes due to failures.
Internal ID A unique, user-assigned ID assigned to a transaction for internal communication and tracking.

Accept quote and Back buttons

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