Skip to main content

🧪 API Sandbox Demo

This page demonstrates how you can use the API Sandbox to test Natech APIs in real-time.

Send an API request​

Follow these steps to test any API endpoint from this page (or from any OpenAPI endpoint page):

1) Choose the server/base URL

  • Open the server selector in the right panel (or the Base URL field in the sandbox) and ensure it points to your sandbox domain.
  • If your endpoint supports multiple environments, pick the appropriate one before proceeding.

2) Fill path and query parameters

  • For parameters shown under Parameters, enter values for all required fields.
  • Path params replace placeholders in the URL (for example, {id}), while query params are appended as ?key=value.

3) Add headers

  • Add required headers (for example, Authorization: Bearer <token>, X-Request-ID, Content-Type).
  • Use the examples as a starting point, then adjust to your credentials and scenario.

4) Provide a request body (when applicable)

  • For POST/PUT/PATCH endpoints, paste or edit a JSON body in the Request Body area.
  • Ensure the JSON is valid; if unsure, copy the example and tweak values.

5) Review the final request

  • Check the Request URL preview to confirm path and query params are correctly inserted.
  • Verify method, headers, and body before sending.

6) Send the request

  • Click the Send API Request button (or the Send Request button in the sandbox component).
  • The live response will appear with status, headers, and a prettified body.

7) Inspect the response

  • 2xx responses indicate success; 4xx/5xx responses include error details and hints.
  • Use the response body and headers to validate your scenario.

Troubleshooting

  • 401/403: Check your token/API key, header names, and scopes.
  • 400: Validate required parameters and request body schema.
  • CORS errors: Use the Sandbox environment, or route through an allowed proxy if needed.
  • Timeouts: Verify the server URL and network connectivity; try simpler requests first.

Mobile Banking API - Get All Accounts​

This endpoint returns all accounts for a user.

POST/api/Accounts/GetAll

Retrieve all user accounts

🌐 Base URL

📋 Examples

📝 Request Body

🔗 Request URL

https://api.natech.com/api/Accounts/GetAll

📥 Response

Click "Send Request" to see the response

AML API - Get Account by IBAN​

An example GET endpoint from the AML API.

GET/Accounts/{iban}

Retrieve account with specific IBAN

🌐 Base URL

📋 Examples

⚙️ Parameters

The International Bank Account Number (IBAN) of the account

🔗 Request URL

https://aml-api.natech.com/Accounts/{iban}

📥 Response

Click "Send Request" to see the response

PSD2 API - Create Payment Consent​

Example POST endpoint for creating payment consent in the PSD2 API.

POST/v1/payments/sepa-credit-transfers

Create new SEPA payment

🌐 Base URL

📋 Examples

⚙️ Parameters

Unique identifier for the request

IP address of the PSU

📝 Request Body

🔗 Request URL

https://psd2-api.natech.com/v1/payments/sepa-credit-transfers

📥 Response

Click "Send Request" to see the response

Usage Guide​

🔑 Authentication​

  • For Mobile Banking APIs, use Bearer token in the Authorization header
  • For AML APIs, use API Key in the X-API-Key header
  • For PSD2 APIs, use OAuth2 Bearer token

📝 Request Bodies​

  • All POST/PUT requests require a JSON body
  • Use the examples as a starting point
  • Modify values according to your needs

🔍 Testing Tips​

  1. Start with the predefined examples
  2. Change one parameter at a time to see the differences
  3. Check status codes and error messages
  4. Use different authentication tokens for testing

⚠️ Important Notes​

  • The APIs are in sandbox mode for testing
  • No real transactions will be processed
  • The tokens used are for demo purposes only
  • For production use, contact the Natech team