Create a Payment
Guides

Create a Payment

Initiating a pending payment record on-chain for a configured pool.

Create an on-chain pending payment record linked to an active pool.

Payment Initiation Overview

Creating a payment establishes an on-chain intent to disburse tokens. The amount is specified in the asset's smallest unit (stroops for XLM, where 1 XLM = 10,000,000 stroops).

Creating via Stellar CLI

CONTRACT="CCOXHXGFTYVRRCJ7U32QZJCWXDTNQLRMDS3IAGW5MGFEWOUEXNYYKLHF"
# Create Payment #1 for 50 XLM (500,000,000 stroops) targeting Pool #1
stellar contract invoke \
--id "$CONTRACT" \
--source payer \
--network testnet \
-- \
create_payment \
--payment_id 1 \
--pool_id 1 \
--payer "$(stellar keys address payer)" \
--amount 500000000

Verifying Pending Payment State

stellar contract invoke \
--id "$CONTRACT" \
--source payer \
--network testnet \
-- \
get_payment \
--payment_id 1

Confirm that status returns PaymentStatus::Pending (1).