Agent Pay Send: Pay Money Out to Payees

contract = atoa.contract.create(
    type="SEND",
    name="Supplier payouts",
    limits={
        "max_per_payment": 500.00,
        "period_limits": [{"amount": 2000.00, "period": "MONTH"}],
        "valid_to": "2026-12-31T23:59:59Z",
    },
)

print(contract.authorization_url)               # the account OWNER approves here, at their bank
atoa.contract.await_active(contract.contract_id)         # → ACTIVE

const contract = await atoa.contract.create({
  type: "SEND",
  name: "Supplier payouts",
  limits: {
    maxPerPayment: 500.00,
    periodLimits: [{ amount: 2000.00, period: "MONTH" }],
    validTo: "2026-12-31T23:59:59Z",
  },
});

console.log(contract.authorizationUrl);         // the account OWNER approves here, at their bank
await atoa.contract.awaitActive(contract.contractId);   // → ACTIVE

result = atoa.payment.send(
    contract_id=contract.contract_id,
    payments=[{
        "amount": {"amount": 250.00},
        "beneficiary": {"name": "ACME LTD", "sortCode": "040004", "accountNumber": "12345678"},
        "orderId": "payout-3001",
        "reference": "Invoice 2043",
    }],
)
# result.next_action — the owner approves before money moves (next section)

const result = await atoa.payment.send({
  contractId: contract.contractId,
  payments: [{
    amount: { amount: 250.00 },
    beneficiary: { name: "ACME LTD", sortCode: "040004", accountNumber: "12345678" },
    orderId: "payout-3001",
    reference: "Invoice 2043",
  }],
});
// result.nextAction — the owner approves before money moves (next section)

send_to_owner(result.next_action.approval_url)     # your own delivery
decision = atoa.payment.await_decision(result.next_action.approval_id)
print(decision.status)                             # APPROVED / DECLINED / EXPIRED

for p in result:                                   # result is still a list[Payment]
    print(p.order_id, p.status, p.failure_reason or "")   # e.g. NAME_MISMATCH, LIMIT_EXCEEDED

sendToOwner(result.nextAction.approvalUrl);        // your own delivery
const decision = await atoa.payment.awaitDecision(result.nextAction.approvalId);
console.log(decision.status);                      // APPROVED / DECLINED / EXPIRED

for (const p of result) {                          // result is still a Payment[]
  console.log(p.orderId, p.status, p.failureReason ?? "");   // e.g. NAME_MISMATCH, LIMIT_EXCEEDED
}

payments = atoa.payment.send(
    contract_id=contract.contract_id,
    payments=[
        {"amount": {"amount": 120.00}, "beneficiary": {"name": "ACME LTD", "sortCode": "040004", "accountNumber": "12345678"}, "orderId": "batch-1"},
        {"amount": {"amount": 80.00},  "beneficiary": {"name": "GLOBEX",   "sortCode": "040004", "accountNumber": "12345678"}, "orderId": "batch-2"},
    ],
)

for p in payments:
    print(p.order_id, p.status)

const payments = await atoa.payment.send({
  contractId: contract.contractId,
  payments: [
    { amount: { amount: 120.00 }, beneficiary: { name: "ACME LTD", sortCode: "040004", accountNumber: "12345678" }, orderId: "batch-1" },
    { amount: { amount: 80.00 },  beneficiary: { name: "GLOBEX",   sortCode: "040004", accountNumber: "12345678" }, orderId: "batch-2" },
  ],
});

for (const p of payments) {
  console.log(p.orderId, p.status);
}

updated = atoa.contract.update(
    contract.contract_id,
    limits={"max_per_payment": 750.00, "period_limits": [{"amount": 3000.00, "period": "MONTH"}], "valid_to": "2027-06-30T23:59:59Z"},
)
print(updated.authorization_url)         # owner re-approves the new caps

atoa.contract.revoke(contract.contract_id)

const updated = await atoa.contract.update(contract.contractId, {
  limits: { maxPerPayment: 750.00, periodLimits: [{ amount: 3000.00, period: "MONTH" }], validTo: "2027-06-30T23:59:59Z" },
});
console.log(updated.authorizationUrl);   // owner re-approves the new caps

await atoa.contract.revoke(contract.contractId);