Updated on 2026-08-14

app/src/main/java/org/stellar/sdk/PaymentOperation.java

@@ -0,0 +1,123 @@
+package org.stellar.sdk;
+
+import org.stellar.sdk.xdr.AccountID;
+import org.stellar.sdk.xdr.Int64;
+import org.stellar.sdk.xdr.OperationType;
+import org.stellar.sdk.xdr.PaymentOp;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+/**
+ * Represents <a href="https://www.stellar.org/developers/learn/concepts/list-of-operations.html#payment" target="_blank">Payment</a> operation.
+ * @see <a href="https://www.stellar.org/developers/learn/concepts/list-of-operations.html" target="_blank">List of Operations</a>
+ */
+public class PaymentOperation extends Operation {
+
+  private final KeyPair destination;
+  private final Asset asset;
+  private final String amount;
+
+  private PaymentOperation(KeyPair destination, Asset asset, String amount) {
+    this.destination = checkNotNull(destination, "destination cannot be null");
+    this.asset = checkNotNull(asset, "asset cannot be null");
+    this.amount = checkNotNull(amount, "amount cannot be null");
+  }
+
+  /**
+   * Account that receives the payment.
+   */
+  public KeyPair getDestination() {
+    return destination;
+  }
+
+  /**
+   * Asset to send to the destination account.
+   */
+  public Asset getAsset() {
+    return asset;
+  }
+
+  /**
+   * Amount of the asset to send.
+   */
+  public String getAmount() {
+    return amount;
+  }
+
+  @Override
+  org.stellar.sdk.xdr.Operation.OperationBody toOperationBody() {
+    PaymentOp op = new PaymentOp();
+
+    // destination
+    AccountID destination = new AccountID();
+    destination.setAccountID(this.destination.getXdrPublicKey());
+    op.setDestination(destination);
+    // asset
+    op.setAsset(asset.toXdr());
+    // amount
+    Int64 amount = new Int64();
+    amount.setInt64(Operation.toXdrAmount(this.amount));
+    op.setAmount(amount);
+
+    org.stellar.sdk.xdr.Operation.OperationBody body = new org.stellar.sdk.xdr.Operation.OperationBody();
+    body.setDiscriminant(OperationType.PAYMENT);
+    body.setPaymentOp(op);
+    return body;
+  }
+
+  /**
+   * Builds Payment operation.
+   * @see PathPaymentOperation
+   */
+  public static class Builder {
+    private final KeyPair destination;
+    private final Asset asset;
+    private final String amount;
+
+    private KeyPair mSourceAccount;
+
+    /**
+     * Construct a new PaymentOperation builder from a PaymentOp XDR.
+     * @param op {@link PaymentOp}
+     */
+    Builder(PaymentOp op) {
+      destination = KeyPair.fromXdrPublicKey(op.getDestination().getAccountID());
+      asset = Asset.fromXdr(op.getAsset());
+      amount = Operation.fromXdrAmount(op.getAmount().getInt64().longValue());
+    }
+
+    /**
+     * Creates a new PaymentOperation builder.
+     * @param destination The destination keypair (uses only the public key).
+     * @param asset The asset to send.
+     * @param amount The amount to send in lumens.
+     * @throws ArithmeticException when amount has more than 7 decimal places.
+     */
+    public Builder(KeyPair destination, Asset asset, String amount) {
+      this.destination = destination;
+      this.asset = asset;
+      this.amount = amount;
+    }
+
+    /**
+     * Sets the source account for this operation.
+     * @param account The operation's source account.
+     * @return Builder object so you can chain methods.
+     */
+    public Builder setSourceAccount(KeyPair account) {
+      mSourceAccount = account;
+      return this;
+    }
+
+    /**
+     * Builds an operation
+     */
+    public PaymentOperation build() {
+      PaymentOperation operation = new PaymentOperation(destination, asset, amount);
+      if (mSourceAccount != null) {
+        operation.setSourceAccount(mSourceAccount);
+      }
+      return operation;
+    }
+  }
+}