ID yêu cầu không được chỉ định. Mã định danh thanh toán duy nhất là gì? Làm cách nào để tìm ra số nhận dạng thanh toán duy nhất? Ví dụ về yêu cầu kiểm tra trạng thái tài khoản của người đăng ký và đăng ký thanh toán
Việc kiểm tra được thực hiện để đảm bảo rằng hóa đơn và khoản thanh toán tiếp theo có thể được xử lý chính xác ở phía Dự án.
Với sự tích hợp đơn giản hóa, ID người dùng và đơn hàng được kiểm tra hai lần: khi chuyển đến hình thức thanh toán và khi chọn phương thức thanh toán.
Dự án cần:
- ID người dùng hoặc URL xác minh đơn hàng(chỉ định trong Cài đặt kỹ thuật trong Tài khoản cá nhân của bạn);
- Trình xử lý có khả năng chấp nhận và nhận dạng các tham số yêu cầu từ Hệ thống và phản hồi như Hệ thống mong đợi.
Nếu xác minh ID sau khi xuất hóa đơn không thành công thì hóa đơn sẽ không được xuất và người dùng sẽ được chuyển hướng đến trang lỗi thanh toán do dự án chỉ định bằng tham số return_url_fail hoặc trong Cài đặt kỹ thuật (nếu trang này không được chỉ định thì một trang tương tự ở phía Hệ thống sẽ được sử dụng). Một tham số được tự động gửi đến trang lỗi thanh toán bằng phương thức GET lỗi_tin nhắn có ý nghĩa "Nhân vật như vậy không tồn tại".
Yêu cầu tham số từ System đến Project
Hệ thống gửi Dự án một yêu cầu tới URL để kiểm tra ID người dùng hoặc đơn đặt hàng được chỉ định trong Cài đặt kỹ thuật trong Tài khoản cá nhân.
- phương thức chuyển giao - BƯU KIỆN;
- mã hóa - UTF-8.
Tham số |
Mô tả về Thông Số |
Định dạng tham số |
Tham số bắt buộc |
|---|---|---|---|
| tên người dùng | ID người dùng hoặc đơn hàng (bằng giá trị tham số tên nick V ) | chuỗi(256) | Đúng |
| userid_extra | Thông tin bổ sung cần thiết để thực hiện thanh toán hoặc thu thập số liệu thống kê về phía Dự án (bằng giá trị tham số nick_extra ) | chuỗi (500) | KHÔNG |
| chìa khóa |
Chữ ký xác nhận của yêu cầu. Nó được hình thành dưới dạng hàm băm bằng thuật toán md5 từ việc ghép các tham số sau:
|
md5(bí mật 0userid0project) | Đúng |
| số lượng | 0 | Đúng | |
| id thanh toán | Kiểm tra yêu cầu kiểm tra. Chỉ chấp nhận giá trị 0 (số tiền = 0) | 0 | Đúng |
| thứ tự | ID thanh toán trong hệ thống kế toán Dự án (bằng giá trị tham số order_id V ) | varchar(64) | KHÔNG |
Tùy chọn phản hồi dự án
Yêu cầu của Hệ thống từ Dự án phải nhận được phản hồi.
Các quy tắc sau được sử dụng để truyền tham số yêu cầu:
- định dạng - XML;
- mã hóa - UTF-8.
Tham số |
Mô tả về Thông Số |
Định dạng tham số |
Tham số bắt buộc |
|---|---|---|---|
| mã số |
Yêu cầu mã phản hồi.
|
(trường hợp nhạy cảm) |
Đúng |
| bình luận | Giải mã mã phản hồi theo yêu cầu. Ví dụ văn bản:
|
chuỗi (400) | KHÔNG |
Ví dụ về phản hồi đối với ID người dùng hoặc yêu cầu xác minh đơn hàng
ĐÚNG
Ví dụ về trình xử lý yêu cầu hệ thống tối thiểu khi kiểm tra ID người dùng hoặc đơn hàng
//Tạo hàm phản hồi sendResponse($status, $message = "")( $response = ""."\n"; $response .= " ".$trạng thái.""."\n"; $response .= "
Số nhận dạng thanh toán duy nhất - nó là gì? Nó dùng để làm gì? Đây là những câu hỏi phổ biến nhất mà doanh nhân đặt ra khi nộp thuế tại ngân hàng, khi nhân viên ngân hàng yêu cầu nêu rõ điều này gây nhầm lẫn. Tôi có thể tìm thấy nó ở đâu, làm cách nào để có được nó và tôi có thể làm gì nếu không có nó? Do đó, một công cụ được tạo ra để đơn giản hóa thủ tục đã dẫn đến những vấn đề mới cần được làm rõ.
Mã định danh duy nhất là gì?
Mã nhận dạng thanh toán duy nhất là mã gồm 20 chữ số phải được chỉ định khi thanh toán các khoản nợ thuế, giúp bạn có thể nộp thuế từ tài khoản cá nhân trên trang web dịch vụ thuế một cách dễ dàng và nhanh chóng. Cách tiếp cận này giúp đơn giản hóa và tăng tốc đáng kể quy trình vận hành. Việc thanh toán diễn ra nhanh chóng và do đó đúng thời hạn, tránh được sự chậm trễ, đồng nghĩa với việc bị phạt và lãi suất.
Việc sử dụng mã định danh duy nhất cho phép các doanh nhân, pháp nhân và cá nhân nộp thuế một cách thuận tiện. Nhưng việc nhận và điền các biểu mẫu chứng từ thuế trong trường hợp này có những đặc điểm riêng cần phải tính đến. Vấn đề còn nằm ở chỗ bản thân dịch vụ thông tin của chính phủ có cấu trúc phức tạp, khó hiểu mà ngay cả người dùng có kinh nghiệm cũng không phải lúc nào cũng có thể hiểu được.
Nó dùng để làm gì?
Điều này là cần thiết để Dịch vụ Thuế Liên bang biết tiền được nhận vào tài khoản khi nào và từ ai. Có hàng triệu người dùng đã đăng ký trong GIS, rất khó để xác định tiền được chuyển từ ai và vì mục đích gì. Đó là lý do tại sao, theo lệnh của Bộ Tài chính số 107n ngày 12 tháng 11 năm 2013, các quy định đã được thay đổi, theo đó một mã định danh duy nhất cho các khoản thanh toán dồn tích xuất hiện riêng cho thuế.
Cơ quan thuế cần nó để thực hiện chính sách tài khóa hiệu quả hơn và xác định những đối tượng vi phạm dai dẳng. Các pháp nhân và cá nhân cần nó như một cách nộp thuế thuận tiện và nhanh nhất. Nhờ đó, Chính phủ có thể kiểm soát hành động của cán bộ thuế và ngăn chặn các trường hợp hành động của họ vượt quá thẩm quyền được giao, điều thường xảy ra trước đây. Doanh nhân ít phụ thuộc vào ý chí cá nhân và bị tống tiền bất hợp pháp. Số lượng các cuộc thanh tra được thực hiện đã giảm.
Ai nên chỉ ra nó?
Cả công dân bình thường, doanh nhân (cá nhân) và pháp nhân đều có thể chỉ ra số nhận dạng thanh toán duy nhất. Việc này có thể thực hiện khi nộp thuế trực tiếp vào tài khoản hệ thống thông tin hoặc qua ngân hàng. Khi chuyển khoản, bạn nên tính đến việc thanh toán qua Sberbank có những đặc điểm riêng. Họ có biểu mẫu đặc biệt của riêng mình, khi điền vào, không cần chỉ định mã định danh duy nhất. UIN được chỉ định khi nộp thuế và nghĩa vụ nhà nước thông qua dịch vụ Dịch vụ Nhà nước hoặc chi nhánh ngân hàng.
Nếu cá nhân hoặc pháp nhân điền chứng từ thanh toán để nộp thuế, phí mà chưa hết thời hạn thanh toán thì không được nhập mã định danh duy nhất mà phải chèn số 0 vào ngày đến hạn để nhập thông tin chi tiết. Mặc dù hình thức điền dòng này được pháp luật cho phép nhưng khi thanh toán qua ngân hàng, nhân viên có thể yêu cầu điền dòng số thanh toán gồm 20 chữ số và có quyền từ chối nhận thanh toán. Vì vậy, điều quan trọng là phải biết trường hợp nào phải chỉ định, trường hợp nào không cần thiết.
Trong trường hợp nào cần phải chỉ ra nó?
Cần lưu ý rằng không phải lúc nào cũng cần chỉ định số nhận dạng mà chỉ trong một số trường hợp nhất định được mô tả trong các quy tắc và quy định của Ngân hàng Nga (đặc biệt là quy định số 383-P). UIN - mã định danh duy nhất được chỉ định trong hai trường hợp:
- Nếu nó được người nhận tiền chỉ định và cung cấp cho một cá nhân hoặc pháp nhân có nghĩa vụ thanh toán cho họ theo các điều khoản của thỏa thuận. Trong trường hợp này, mã định danh được gán tự động.
- Khi chuyển tiền cho cơ quan thuế. Doanh nhân hoặc cá nhân điền vào các trường (dòng) đặc biệt của phiếu thanh toán ở dạng giấy hoặc điện tử. Trong trường hợp này, việc làm đầy gây ra một số khó khăn. Suy cho cùng, một doanh nhân không phải lúc nào cũng biết số nhận dạng thanh toán duy nhất của mình hoặc nơi lấy nó.
Trường hợp thứ hai, hầu hết người nộp thuế đều gặp khó khăn vì không biết lấy ở đâu và ghi ở đâu trong văn bản. Và dữ liệu được chỉ định không chính xác dẫn đến sự chậm trễ trong thanh toán, phạt và phạt.
Tôi có thể lấy ID ở đâu và bằng cách nào?
Làm cách nào tôi có thể tìm hiểu thông tin về số nhận dạng thanh toán duy nhất cũng như liệu khoản thanh toán có được chấp nhận hay không? Bạn có thể kiểm tra điều này cả trong tài khoản cá nhân GIS của mình sau khi đăng ký vào hệ thống và khi nhận được lệnh thanh toán trong trường hợp thanh toán trễ. Nhưng đây là một trường hợp cực đoan. Doanh nhân sẽ biết con số từ các tài liệu cho thấy sự hiện diện của một khoản nợ hoặc tiền phạt đối với cơ quan thuế.
Nếu không có khoản thanh toán quá hạn nhưng bạn cần cho biết UIN thì bạn chỉ cần gửi yêu cầu đến cơ quan thuế để lấy số.
Làm thế nào để điền nó một cách chính xác?
Khi người nộp thuế thực hiện thanh toán vào hệ thống ngân sách của Liên bang Nga, họ sẽ điền vào lệnh thanh toán. Ngoài mã định danh duy nhất, doanh nhân phải cho biết:
- BIC của tổ chức thực hiện thanh toán;
- tên ngân hàng, địa chỉ hợp pháp của ngân hàng;
- tài khoản hiện tại mà việc chuyển tiền sẽ được thực hiện;
- loại thanh toán (mã);
- ngày thực hiện hoạt động.
Số được nhập vào dòng mã định danh thanh toán duy nhất - 22 (mã trường). Đừng chỉ điền vào nếu thanh toán xảy ra đúng thời hạn. Trong trường hợp này, hãy nhập “0” (không) vào dòng này.
Phải làm gì nếu tài liệu đã chứa UIN?
Đôi khi, đặc biệt là khi thực hiện thanh toán thông qua các hệ thống thông tin chuyên dụng, khi điền đơn đặt hàng điện tử trong dòng (mã của nó là 22), một mã nhận dạng thanh toán duy nhất sẽ tự xuất hiện. Chúng ta nên cảm thấy thế nào về điều này? Đây có được coi là lỗi nếu tiền được gửi đúng hạn không? Trong thực tế, không có lỗi. Bạn có thể thanh toán bằng cách cho biết số ID hoặc bằng cách nhập “0” vào dòng. Họ chỉ yêu cầu bạn cho biết mã nhận dạng khi thanh toán chậm, tức là theo yêu cầu của cơ quan thuế.
Mặc dù có thể thanh toán mà không bị hạn chế nhưng cách làm này không được mong muốn. Doanh nghiệp phải phân biệt giữa thuế nộp thông thường và thuế nộp theo yêu cầu của cơ quan thuế. Điều này sẽ giúp tránh nhầm lẫn trong quá trình báo cáo.
Nhưng ngay cả khi không thể tìm ra và chỉ ra số nhận dạng trong đơn đặt hàng, điều này không mang lại cho ngân hàng quyền từ chối chấp nhận nó. Ngân hàng có nghĩa vụ chấp nhận và chuyển tiền, ngay cả khi UIP (mã nhận dạng thanh toán duy nhất) không được chỉ định. Quy tắc này được nêu trong các tài liệu chính thức của cơ quan thuế. Nó nêu rõ rằng một cá nhân hoặc pháp nhân chỉ cần cho biết mã TIN của mình và nhập “0” vào dòng (mã 22) của mã định danh thanh toán duy nhất. Trong trường hợp này, ngân hàng không có quyền từ chối chuyển khoản thanh toán. Nhưng doanh nhân phải lưu ý rằng trong trường hợp xảy ra sai sót hoặc chậm trễ thì ngân hàng không chịu trách nhiệm.
Mã có nghĩa là gì: giải mã mã định danh
Mã định danh được giải mã như sau:
- Các số từ 1 đến 3 cho biết mã của cơ quan thuế nơi nhận tiền.
- Số 4 cho biết loại thanh toán. Nơi này luôn bằng không.
- Các số từ 5 đến 19. Cho biết mã chứng từ trong hệ thống thuế. Mỗi người trả tiền được gán mã đặc biệt của riêng mình, dựa trên phiên bản trước của chỉ mục tài liệu.
- Chữ số 20. Số của nó xác định cơ quan chính phủ nào đang xác minh khoản thanh toán. Tính toán có tính đến 19 chữ số còn lại của mã.
Mã định danh thanh toán duy nhất giống với chỉ mục tài liệu chỉ khi chỉ mục bao gồm 20 chữ số.
Điều gì xảy ra nếu bạn không chỉ định nó?
Sử dụng số UIN, thuế và các khoản thanh toán khác vào ngân sách sẽ được ghi lại tự động. Thông tin về các khoản thanh toán cho ngân sách được chuyển đến một cơ sở dữ liệu duy nhất. Nếu bạn nhập sai mã hoặc không chỉ định, hệ thống sẽ không ghi nhận khoản thanh toán và tiền sẽ không được chuyển. Điều này đầy rẫy những rắc rối như:
- công ty sẽ phải gánh chịu nợ ngân sách và quỹ;
- hình phạt sẽ tiếp tục tích lũy;
- bạn sẽ cần làm rõ khoản thanh toán và tìm hiểu số phận của nó;
- tiền sẽ đến ngân sách hoặc quỹ một cách chậm trễ.
Nếu một doanh nhân không có hoặc không biết mã định danh thanh toán duy nhất để lấy nó ở đâu, anh ta có thể sử dụng dịch vụ hỗ trợ trong GIS bất kỳ lúc nào, thay vì chờ cơ quan thuế hành động. Nếu một doanh nhân không có quyền truy cập vào Internet và hệ thống điện tử của Dịch vụ Nhà nước, anh ta có thể gửi thư thông thường đến cơ quan thuế gần nhất hoặc trực tiếp đến để nhận mã nhận dạng.
Cần những giấy tờ gì để có được ID?
Tất cả phụ thuộc vào hình thức tài liệu sẽ được soạn thảo và cách thanh toán. Nếu đây là văn bản giấy thì phải có văn bản đề nghị cơ quan thuế. Trong thư, hãy cho biết chi tiết hộ chiếu, số INN và SNILS của bạn. Mã nhận dạng thanh toán duy nhất sẽ được gửi trong thư phản hồi. Nếu một pháp nhân hoặc cá nhân trực tiếp đến cơ quan để nhận thông tin này thì những tài liệu này phải được mang theo bên mình. Họ được yêu cầu điền vào các mẫu đơn.
Để nhận thông tin chi tiết bằng điện tử, trước tiên bạn phải đăng ký vào hệ thống thông tin thống nhất trên trang web của Dịch vụ Nhà nước, cho biết dữ liệu giống như với yêu cầu bằng văn bản. Sau đó, một lá thư sẽ được gửi đến nơi bạn ở cùng với khóa truy cập. Và chỉ sau đó, bạn mới có thể đưa ra yêu cầu để có được mã định danh duy nhất. Thông thường dịch vụ này được cung cấp trong vòng vài giờ sau khi đăng ký. Không có tài liệu được yêu cầu.
Như bạn có thể thấy, không có gì phức tạp khi sử dụng mã định danh. Sẽ không khó để nhận ra anh ấy. Để làm điều này, bạn không cần phải thu thập nhiều tài liệu hoặc chứng chỉ. Nhưng thuế có thể được nộp dưới hình thức thuận tiện và bất cứ lúc nào. Nếu trước đây các pháp nhân và cá nhân phải dành thời gian và tiền bạc để nộp thuế, thì với sự trợ giúp của nó, họ có thể được nộp thuế mà không cần rời khỏi nhà hoặc văn phòng, không làm gián đoạn công việc.
- Giao diện phải chấp nhận các yêu cầu HTTPS từ các địa chỉ IP mạng con:
- 79.142.16.0, mặt nạ 255.255.240.0 (20)
- 91.232.230.0, mặt nạ 255.255.254.0 (23)
- Giao diện phải xử lý các tham số được hệ thống truyền bằng phương thức HTTP GET.
- Giao diện phải tạo phản hồi cho hệ thống ở định dạng XML theo mã hóa UTF-8.
- Việc trao đổi thông tin được thực hiện ở chế độ “yêu cầu-phản hồi” và tốc độ phản hồi không được vượt quá 60 giây, nếu không hệ thống sẽ ngắt kết nối do hết thời gian chờ.
- Nếu số lượng thanh toán dự kiến cho các dịch vụ của nhà cung cấp được kết nối dự kiến sẽ lớn (tối đa 10 khoản thanh toán mỗi phút trở lên), thì giao diện cần hỗ trợ giao tiếp đa luồng lên tới 10-15 kết nối đồng thời.
- Giao diện phải chấp nhận yêu cầu qua giao thức HTTPS trên một trong các cổng TCP sau: 80, 81, 443, 8008, 8080, 8081, 8090, 8443, 4433. Không được phép sử dụng các cổng khác.
Nguyên tắc cơ bản của giao diện
Tất cả các yêu cầu được gửi bằng phương thức GET, các tham số được truyền trong đường dẫn yêu cầu.
Việc chuyển thông tin thanh toán đến nhà cung cấp được hệ thống Ví QIWI thực hiện theo hai giai đoạn - kiểm tra trạng thái của người đăng ký và trực tiếp thực hiện thanh toán. Giai đoạn sơ bộ để có được các thông số thanh toán bổ sung từ nhà cung cấp cung cấp cho người đăng ký một số dịch vụ cũng có thể được thêm vào để thông báo cho người trả tiền và thêm các thông số thanh toán theo lựa chọn của người trả tiền.
Loại yêu cầu được hệ thống Ví QIWI truyền đi trong biến lệnh - một chuỗi lấy các giá trị check, pay hoặc getInfo:
Tham số truy vấn
Tất cả các tham số đều được yêu cầu trong các truy vấn mà chúng được sử dụng.
| Tham số | Định dạng | Sự miêu tả | Nó được sử dụng trong những truy vấn nào? |
|---|---|---|---|
| txn_id | Số nguyên dài tối đa 20 ký tự | Mã định danh thanh toán duy nhất trong hệ thống QIWI. Mã định danh này được sử dụng để giải quyết các vấn đề gây tranh cãi. | kiểm tra, trả tiền |
| Tổng | Một số phân số chính xác đến phần trăm được sử dụng làm dấu phân cách. (chấm). Nếu tổng đại diện cho một số nguyên, thì nó vẫn được bổ sung bằng dấu chấm và số không, ví dụ - 152,00. | Số tiền thanh toán | kiểm tra, trả tiền |
| ccy | Mã tiền tệ Alpha-3 ISO 4217 | Đồng tiền thanh toán | kiểm tra, trả tiền |
| txn_date | YYYYMMDDHHMMSS | Ngày thanh toán (ngày thanh toán trên hệ thống là ngày nhận được yêu cầu từ khách hàng). Dựa trên ngày này, việc đối chiếu thêm các khoản thanh toán chung giữa Ví QIWI và nhà cung cấp sẽ được thực hiện. Ví dụ: khách hàng đã gửi yêu cầu đến hệ thống Ví QIWI vào ngày 31/12/2010 lúc 23:59:59 và hệ thống Ví QIWI đã gửi yêu cầu đến nhà cung cấp vào ngày 01/01/2011 lúc 00:00:05. Điều này có thể dẫn đến vấn đề đối chiếu thanh toán nếu hệ thống của nhà cung cấp thực hiện giao dịch vào kỳ thanh toán tiếp theo. Để tránh những vấn đề như vậy, Ví QIWI cung cấp cho nhà cung cấp ngày thanh toán ban đầu. |
chi trả |
| tài khoản | Một chuỗi chứa các chữ cái, số và ký tự đặc biệt, dài tối đa 200 ký tự | ID người đăng ký. Nhà cung cấp xác định thuê bao của mình bằng một mã định danh duy nhất (số tài khoản cá nhân, số điện thoại, thông tin đăng nhập, v.v.). Trước khi được gửi đến nhà cung cấp, mã định danh được xác thực theo biểu thức chính quy. | kiểm tra, thanh toán, getInfo |
| thêm | Các số được chấp nhận là số (0-9), dấu gạch dưới (_) và chữ cái Latinh viết thường (a-z) | Chi tiết thanh toán bổ sung (các trường bổ sung). Các tham số này có thể được sử dụng nếu không thể thực hiện thanh toán nếu không có dữ liệu bổ sung (một ID người dùng trong hệ thống của nhà cung cấp là không đủ). Ví dụ: ID người dùng là số thẻ tín dụng, nhưng để thực hiện thanh toán, bạn cũng cần chỉ định ngày hết hạn của thẻ. Danh sách các trường bắt buộc được chuyển đến nhà cung cấp phải được chỉ định ở dạng . |
kiểm tra, trả tiền |
| privId | số nguyên | Mã định danh dịch vụ trong hệ thống chung của nhà cung cấp. | nhận thông tin |
| tên_tham số | Định dạng tên và giá trị của các tham số được nhà cung cấp chỉ định trong . | Các thông số bổ sung để nhận dạng thuê bao | nhận thông tin |
Để hỗ trợ khả năng mở rộng và duy trì chức năng dịch vụ của nhà cung cấp trong thời gian kích hoạt các chức năng khác nhau do giao thức cung cấp (ví dụ: cho phép chuyển chi tiết thanh toán mới), giả định rằng nhà cung cấp không ngăn chặn sự xuất hiện của các giao thức mới. Tham số HTTP trong yêu cầu.
Nó được đảm bảo rằng sự xuất hiện của các tham số mới trong yêu cầu sẽ không dẫn đến nhu cầu thay đổi việc xử lý yêu cầu từ phía nhà cung cấp, trừ khi sự thay đổi logic đó đã được thỏa thuận với nhà cung cấp.
Định dạng phản hồi
Nhà cung cấp phải trả lại phản hồi cho các yêu cầu tới hệ thống ở định dạng XML. Cấu trúc chung của câu trả lời được hiển thị trong tab bên phải.
Nếu bất kỳ yêu cầu nào tới nhà cung cấp không thành công, nhà cung cấp sẽ trả về mã lỗi theo .
Hệ thống thông tin của nhà cung cấp không được chứa hai khoản thanh toán được hoàn thành thành công có cùng số txn_id. Nếu hệ thống gửi lại yêu cầu có mã định danh txn_id đã tồn tại trong hệ thống thông tin của nhà cung cấp thì nhà cung cấp phải trả về kết quả xử lý yêu cầu trước đó.
Phản hồi có thể chứa các thẻ sau:
Ví dụ: có một tình huống: khách hàng gửi yêu cầu đến hệ thống vào ngày 31/12/2010 lúc 23:59:59. Do sự chậm trễ trong việc xử lý dữ liệu và gửi thông tin qua các kênh liên lạc, khoản thanh toán sẽ được nhà cung cấp nhận vào ngày 01/01/2011 00:00:05 và theo đó, sẽ được tính vào hệ thống của nhà cung cấp trong một báo cáo khác Giai đoạn. Để tránh các vấn đề với các kỳ báo cáo khác nhau khi tiến hành đối chiếu, nhà cung cấp cần phải cung cấp ngày thực hiện kế toán trong hệ thống của mình.
Ví dụ về yêu cầu kiểm tra trạng thái tài khoản của người đăng ký và đăng ký thanh toán
Điều kiện ví dụ:
Ứng dụng thanh toán Payment_app của nhà cung cấp được đặt tại yourservice.prv.ru, máy chủ hỗ trợ kết nối HTTPS trên cổng 8443.
Để kiểm tra trạng thái của người đăng ký, hệ thống Ví QIWI sẽ tạo một yêu cầu (xem tab bên phải).
LẤY / Payment_app?command=check&txn_id=1234567& account=4957835959&sum=10.45&ccy=RUBYêu cầu chứa các tham số:
- command=check – mã định danh của yêu cầu kiểm tra trạng thái của người đăng ký;
Phản hồi thành công từ nhà cung cấp (xem tab bên phải).
Trả về kết quả=0 cho yêu cầu kiểm tra cho biết rằng tài khoản cá nhân của người đăng ký có số tương ứng trong trường tài khoản có thể được bổ sung bằng số tiền được chỉ định trong yêu cầu trong trường tổng. Sau khi kiểm tra thành công trạng thái tài khoản của thuê bao, hệ thống tiến hành tạo và gửi yêu cầu nạp tiền vào số dư (yêu cầu thanh toán).
Ví dụ về yêu cầu nạp tiền vào tài khoản cá nhân
Điều kiện ví dụ:
Để xác nhận thanh toán, hệ thống Ví QIWI tạo yêu cầu (xem tab bên phải).
LẤY /thanh toán_app?command=pay&txn_id=1234567& txn_date=20110815120133&account=4957835959&sum=10.45&ccy=RUB Máy chủ HTTP / 1.1 : yourservice.prv.ru:8443 Phản hồi của nhà cung cấpYêu cầu chứa các tham số:
- command=pay – mã định danh của yêu cầu nạp tiền vào số dư của người đăng ký;
- txn_id=1234567 – số thanh toán nội bộ trong hệ thống QIWI;
- txn_date=20090815120133 – ngày đăng ký thanh toán trong hệ thống QIWI;
- account=4957835959 – số nhận dạng thuê bao trong hệ thống thông tin của nhà cung cấp;
- sum=10,45 – số tiền được ghi có vào tài khoản cá nhân của người đăng ký;
- ccy=RUB – loại tiền tệ của số tiền được ghi có vào tài khoản cá nhân của người đăng ký.
Bằng cách trả về kết quả=0 cho yêu cầu thanh toán, nhà cung cấp báo cáo việc hoàn thành thành công hoạt động bổ sung số dư. Hệ thống hoàn tất xử lý giao dịch này.
Trường nhận xét tùy chọn chứa nhận xét dịch vụ.
Ví dụ về yêu cầu dữ liệu thanh toán bổ sung
Điều kiện ví dụ:
Ứng dụng thanh toán Payment_app của nhà cung cấp được đặt tại yourservice.prv.ru, máy chủ hỗ trợ kết nối HTTPS trên cổng 8443.
Để có được dữ liệu thanh toán bổ sung, hệ thống Ví QIWI sẽ tạo một yêu cầu (xem tab bên phải).
LẤY /Payment_app?command=getInfo&prvId=12345& account=4957835959&name1=%26%30AB&name2=0 Máy chủ HTTP / 1.1 : yourservice.prv.ru:8443 Phản hồi của nhà cung cấpYêu cầu chứa các tham số:
- command=getInfo – yêu cầu định danh để lấy dữ liệu thanh toán bổ sung cho người đăng ký;
- prvId=12345 – mã định danh để xác định dịch vụ của nhà cung cấp;
- account=4957835959 – số nhận dạng thuê bao trong hệ thống thông tin của nhà cung cấp;
- name1, name2 – số nhận dạng thuê bao bổ sung.
Xem tab bên phải để biết phản hồi của nhà cung cấp.
Trả về kết quả=0 cho yêu cầu getInfo cho biết rằng yêu cầu đã được hoàn thành thành công và dữ liệu bổ sung sẽ được hiển thị cho người đăng ký đã được nhận.
Trường nhận xét tùy chọn chứa nhận xét dịch vụ.
Hòa giải hàng ngày
Trước 10:00 giờ Moscow, hệ thống sẽ tạo và gửi đến địa chỉ được chỉ định một sổ đăng ký điện tử về các khoản thanh toán được chấp nhận cho ngày hôm trước.
Sổ đăng ký có cấu trúc như sau:
Ngày giao dịch (Moscow);Ngày báo cáo;Loại;Số giao dịch;ID tiền tệ giao dịch;Số tiền giao dịch;Nhận xét của người bán;Số giao dịch/hóa đơn của người bán;Ngày phát hành hóa đơn;ID QW;Tài khoản;ID hoàn tiền
Các trường được phân tách bằng dấu hiệu; , phần phân số của số tiền được phân tách bằng dấu chấm, ngày/giờ là Moscow, nguồn cấp dữ liệu dòng có thể bao gồm các ký tự x0D x0A hoặc đơn giản là x0D.
Ví dụ:
31.02.2005 00:04:00;31.02.2005
00:00:00;Thanh toán;3464968222;USD;5,00;;;;;0957835959;;
31/02/2005 00:04:00;02/31/2005 00:00:00;Thanh toán;3464968912;RUB;10.34;;;;; [email được bảo vệ];;
31/02/2005 00:11:00;02/31/2005 00:00:00;Thanh toán;3464974548;EUR;4,72;;;;;ABC-12345;;
Hệ thống chỉ bao gồm các khoản thanh toán được hoàn thành thành công trong sổ đăng ký.
Các khoản thanh toán nhận được cả qua tin nhắn trực tuyến và trong sổ đăng ký đều được coi là đã xác nhận.
Nếu sổ đăng ký không chứa các khoản thanh toán được thực hiện trong cơ sở dữ liệu của nhà cung cấp hoặc chứa các khoản thanh toán không có trong cơ sở dữ liệu của nhà cung cấp hoặc nếu sổ đăng ký chưa được nhận, bạn phải liên hệ với người liên hệ QIWI được chỉ định trong thỏa thuận trước 12:00 để làm rõ tình hình và đưa ra quyết định.
Tùy chọn ủy quyền yêu cầu bổ sung
Trong ứng dụng kết nối, nhà cung cấp có thể chỉ định mã định danh (đăng nhập) và mật khẩu bí mật cho nó, được sử dụng để ủy quyền khi thực hiện yêu cầu từ QIWI.
Dữ liệu ủy quyền này được truyền theo các quy tắc xác thực cơ bản tiêu chuẩn cho các yêu cầu HTTP(S). Tiêu đề HTTP ủy quyền được thêm vào yêu cầu. Tiêu đề chứa chuỗi Cơ bản (có dấu cách ở cuối) và cặp “đăng nhập: mật khẩu” được mã hóa trong BASE64:
Ủy quyền: Cơ bản ***
BASE64("Đăng nhập:Mật khẩu") = "***"
Đơn xin kết nối (mẫu)
Danh sách mã thoát
Khi xử lý các yêu cầu từ hệ thống, nhà cung cấp phải khớp tất cả các lỗi xảy ra trong ứng dụng của mình với danh sách bên dưới và trả về mã tương ứng trong phần tử.
Dấu + trong cột “tử vong” cho biết lỗi nghiêm trọng. Đối với hệ thống Ví QIWI, lỗi nghiêm trọng có nghĩa là việc gửi lại yêu cầu có cùng thông số sẽ dẫn đến lỗi lặp lại 100% - do đó, hệ thống sẽ ngừng xử lý yêu cầu của khách hàng và hoàn thành yêu cầu đó với một lỗi.
Lỗi không nghiêm trọng có nghĩa là hệ thống lặp lại yêu cầu với cùng thông số sau một khoảng thời gian nhất định có thể sẽ dẫn đến thành công. Hệ thống sẽ lặp lại các yêu cầu không thành công với một lỗi không nghiêm trọng, liên tục tăng khoảng thời gian cho đến khi thao tác thành công hay thất bại hoặc cho đến khi hết thời gian tồn tại 24 giờ của yêu cầu.
Thiếu kết nối với máy chủ của nhà cung cấp là một lỗi không nghiêm trọng.
Việc thiếu một phần tử trong phản hồi (XML không chính xác, trang Dịch vụ tạm thời không có sẵn, v.v.) cũng là một lỗi không nghiêm trọng.
| Mã số |
|---|
Thông tin chung
Mô tả các thông số đầu vào
Mô tả các thông số đầu ra
hoặc
Đầu ra: Tài liệu XML theo lược đồ WS_ULIPOTVID_2_311_09_04_02_01.XSD
Các tham số kiểu phức tạp được mô tả trong Phụ lục “Mô tả cấu trúc dữ liệu chung” (tại đoạn 10, 6, 9).
Mã trả lại
| № | Mã trả lại | Mô tả mã trả về | Điều kiện xảy ra | Một lời bình luận |
| 1 | 01 | Không tìm thấy thông tin được yêu cầu | Xảy ra với điều kiện là thông tin về pháp nhân không được tìm thấy trong Sổ đăng ký pháp nhân thống nhất của nhà nước | |
| 2 | 51 | Yêu cầu được chấp nhận để xử lý | Xảy ra khi một yêu cầu được chấp nhận thành công để xử lý | |
| 3 | 52 | Câu trả lời chưa sẵn sàng | Xảy ra khi phản hồi cho yêu cầu được chấp nhận thành công để xử lý chưa sẵn sàng | Được sử dụng cho yêu cầu không đồng bộ |
| 4 | 53 | Thông tin liên quan đến pháp nhân/doanh nhân cá nhân không thể được cung cấp dưới dạng điện tử | Xảy ra khi không thể tạo phản hồi cho yêu cầu ở dạng điện tử. | |
| 5 | 82 | Lỗi kiểm soát định dạng-logic | Xảy ra khi tài liệu (yêu cầu) không khớp với lược đồ xsd | Dự trữ, có thể không được sử dụng |
| 6 | 83 | Không có yêu cầu nào có ID yêu cầu được chỉ định và loại thông tin được yêu cầu từ cơ quan này | Xảy ra trong trường hợp yêu cầu về kết quả của yêu cầu trích xuất từ một pháp nhân chỉ ra mã định danh yêu cầu không chính xác (không xác định) và (hoặc) không nhận được yêu cầu có mã định danh đó từ cơ quan này | Được sử dụng cho yêu cầu không đồng bộ (khi nhận được kết quả yêu cầu trích xuất từ pháp nhân) |
| 9 | 99 | Lỗi hệ thống | Xảy ra khi có lỗi nội bộ trong phần mềm IS của Cục Thuế Liên bang Nga |
Các trường hợp thử nghiệm
Trả lời yêu cầu nhận kết quả yêu cầu lấy trích lục của pháp nhân trong trường hợp yêu cầu chưa được xử lý
Phản hồi yêu cầu nhận kết quả của yêu cầu lấy bản trích xuất từ pháp nhân có mã trả về 53
Phản hồi yêu cầu về kết quả của yêu cầu trích xuất từ pháp nhân có lỗi (mã xử lý không được bảo lưu)
(giá trị thuộc tính thay đổi và)
| |
Lưu ý: Các điều kiện để xảy ra lỗi này trong môi trường thử nghiệm đã được kích hoạt một cách giả tạo. Ví dụ này mô tả logic và cấu trúc chung của phản hồi lỗi. Khi thử nghiệm trên môi trường sản xuất, việc trả về chính xác cùng một phản hồi mà không cung cấp các điều kiện cần thiết là không thể.
