A payment (pay_*) moves money from your wallet to another party or agent. When the recipient is an email or phone number with no Natural account, the payment waits as a claim until they claim it. To learn more, see Send a payment and Track a payment.
Sent to a recipient with no Natural wallet yet. It waits up to 30 days for them to claim it, and you can cancel it until they do. Unclaimed after 30 days, it fails and the money returns to your wallet.
PROCESSING, COMPLETED, FAILED, CANCELED
IN_REVIEW
Held for review: an approval your limits opened, or a review on Natural’s side. Nothing is sent while it’s held for approval.
The payment finished. It can still be returned only if it paid a payment request; see RETURNED.
RETURNED
FAILED
The payment didn’t go through. failure says why.
Final
RETURNED
The money came back after the payment completed or while it was processing. Only a payment that pays a payment request can be returned. return says why.
Final
APPROVAL_DENIED
Natural’s policy or an approver denied the payment before any money moved.
Final
CANCELED
Canceled before the recipient got the money. A canceled pending claim returns the held amount to your wallet. failure.reason says why.
Final
Events
payment.created: A payment resource was created before approval or money movement submission. The fee is assessed when the payment is sent, so it’s always null on payment.created. Only the sender’s copy carries it. Payments that pay a payment request never carry a fee; the request fee is on paymentRequest.completed.