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 Payments in your chosen environment.
A token carries only the scopes you asked for, so one issued for a different product is rejected here. Request this product's scope, or ask for several scopes in a single token as described on the Authentication page.
Endpoints
| Endpoint | Does |
|---|---|
| SinglePayment | Sends one payment from one account |
| SinglePaymentStatus | Reports where one payment has got to |
| BulkPayment | Sends a batch of payments in one call |
| BulkPaymentStatus | Reports where every payment in a batch has got to |