Skip to content

Paying by bank transfer ​

sh
curl -X POST https://api.example.com/partner/v1/payments \
  -H "Authorization: Bearer ugp_…" -H "Content-Type: application/json" \
  -d '{"service_request_id":"sreq_…","payment_method":"bank_transfer"}'

Answer:

json
{
  "escrow": { "id": "esc_…", "status": "created", "amount": 750 },
  "payment": {
    "mode": "bank_transfer",
    "reference": "UG-102610123456",
    "amount": 750,
    "accounts": [{ "bank_name": "…", "iban": "TR…", "recipient": "…" }]
  }
}
  • Ask the customer to send amount to one of the accounts, with reference in the transfer description.
  • When the transfer is seen (the team's approval or automatic matching) the payment becomes held and the job is dispatched. Follow it with GET /payments?service_request_id=… or GET /notifications/sync.
  • With no active transfer account you get 503 BANK_TRANSFER_UNCONFIGURED. GET /payment-methods shows the open methods up front.