Payments

Overview

A single REST API that fronts multiple Saudi banks. You integrate once; every bank uses the same paths, the same JSON request shape, and the same response envelope. New banks get added on Neotek's side with no change to your integration.

You choose the bank per request with the bankCode field in the body, so switching banks never changes the path you call.


Prerequisites

  • Authentication: Obtain an access token using the OAuth2 Client Credentials flow (see Getting Started → Authentication). Every endpoint in this product takes Authorization: Bearer <ACCESS_TOKEN> — there are no exceptions.
  • Subscription: Subscribe to B2B Unified Product in your chosen environment; it covers all seven B2B Unified products.

All seven B2B Unified products share one scope, b2b_unified. Request it once and the same token works here and on the other six; the Authentication page shows how.


Endpoints

EndpointDoes
SinglePaymentSends one payment from one account
SinglePaymentStatusReports where one payment has got to
BulkPaymentSends a batch of payments in one call
BulkPaymentStatusReports where every payment in a batch has got to
Payments — Overview · neotek Docs