این API برای تطبیق شماره موبایل ارسال شده با شماره …
POST
استعلام
Deposit to IBAN Conversion API
This API endpoint allows you to convert a deposit account number to its corresponding IBAN (International Bank Account Number). The service requires authentication and deducts credits from your wallet upon successful conversion.
POST/api/services/deposit-to-iban/
نیاز به احراز هویت
Token
100 requests/minute
مستندات
Overview
Overview
The Deposit to IBAN Conversion API allows you to convert a deposit account number to its corresponding IBAN (International Bank Account Number). This service is essential for banking operations, payment processing, and financial integrations.
When you make a successful API call, the service will:
Validate the deposit account number format
Validate the bank identifier
Query Sepal Yar to retrieve the IBAN
Deduct credits from your wallet (10,000 Rials per request)
Return the IBAN number along with a unique request reference
Use Cases:
Payment gateway integrations
Banking system integrations
Financial transaction processing
Account verification systems
Authentication
Authentication
This API requires authentication using a Token-based authentication system with a unique code.
How to authenticate:
Obtain your API token and unique code from the admin panel or registration API
Implement connection pooling for high-volume applications
Use async/await patterns where possible
Monitor response times and optimize accordingly
IBAN Format
IBAN Format
The IBAN (International Bank Account Number) returned by this API follows the Iranian IBAN standard:
Format: IR + 24 digits
Total Length: 26 characters
Structure: IR + Check Digits (2) + Bank Code (3) + Account Number (19)
Example:
IR110590011981302295556001
Breaking down the example:
IR: Country code for Iran
11: Check digits
059: Bank code (Sina Bank)
0011981302295556001: Account number
Validation:
You can validate IBAN numbers using standard IBAN validation algorithms. The API ensures that all returned IBANs are valid according to Iranian banking standards.
Usage:
IBAN numbers are used for:
International money transfers
Domestic bank transfers
Payment gateway integrations
Account verification
Pricing
Pricing
Each successful API call deducts credits from your wallet:
Cost per request: 10,000 Rials
Charged only on success: If the request fails (4xx errors), no credits are deducted
Minimum balance: You need at least 10,000 Rials in your wallet to make a request
When credits are deducted:
Credits are deducted only after a successful response from Sepal Yar
If the service returns an error, no credits are deducted
If validation fails before calling the service, no credits are deducted
Request Reference:
Each successful request generates a unique request_ref that can be used for:
Tracking and auditing
Support requests
Billing reconciliation
Wallet Management:
You can check your wallet balance and transaction history through the wallet API endpoints.
پارامترهای درخواست
پارامتر
نوع
اجباری
توضیحات
مثال
deposit
String
اجباری
Deposit account number. Can include dashes (e.g., '119-813-2295556-1') or be plain digits. Spaces and dashes will be preserved in the URL but validated as digits only. Minimum 6 digits required.
اعتبارسنجی: Must contain only digits and dashes. Minimum 6 digits when dashes are removed. Spaces will be automatically removed.
119-813-2295556-1
bank_id
String
اجباری
Bank identifier code. Must be one of the supported bank codes (e.g., SINAIR, MELIIR, BKMTIR, etc.). This is used to identify which bank the deposit account belongs to.
اعتبارسنجی: Must be one of the predefined bank codes. See the bank enum list for all available options.
using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Token YOUR_AUTH_TOKEN");
client.DefaultRequestHeaders.Add("X-Unique-Code", "YOUR_UNIQUE_CODE");
var data = new
{
deposit = "119-813-2295556-1",
bank_id = "SINAIR"
};
var json = JsonSerializer.Serialize(data);
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync(
"https://inquiry.sepal.ir/api/services/deposit-to-iban/",
content
);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
}
}
