Saudi Arabia Payments (Tap Payments — mada / STC Pay)

Create a payment link in SAR for Saudi Arabia via Tap Payments. Buyer pays with mada (the Saudi debit network), Apple Pay, cards, STC Pay — whatever is enabled on the Tap account. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Bring your own credentials via HTTP header (x-tap-secret-key; free test credentials from businesses.tap.company never move real money). Money always flows buyer→Tap Payments→merchant; this service never touches fund…

Check whether a Saudi Arabia payment (created by create_payment_link) has been paid. Queries Tap Payments directly — pull-based, no webhook needed. paid=true when status is PAID.

Refund a paid payment (created by create_payment_link). Full refund by default; pass amount for a partial refund where supported. Refunds respect the same owner policy guardrails (x-agentpay-max-amount) as payments — the amount is checked before anything is sent to the gateway.