[要約] RFC 3538は、IOTPのv1.0に対するSETの補足であり、セキュアな電子取引を可能にするプロトコルです。その目的は、オープンな取引プロトコルにSETのセキュリティ機能を組み込むことです。
Network Working Group Y. Kawatsura Request for Comments: 3538 Hitachi Category: Informational June 2003
Secure Electronic Transaction (SET) Supplement for the v1.0 Internet Open Trading Protocol (IOTP)
V1.0インターネットオープントレーディングプロトコル(IOTP)の安全な電子トランザクション(SET)サプリメント
Status of this Memo
本文書の位置付け
This memo provides information for the Internet community. It does not specify an Internet standard of any kind. Distribution of this memo is unlimited.
このメモは、インターネットコミュニティに情報を提供します。いかなる種類のインターネット標準を指定しません。このメモの配布は無制限です。
Copyright Notice
著作権表示
Copyright (C) The Internet Society (2003). All Rights Reserved.
Copyright(c)The Internet Society(2003)。無断転載を禁じます。
Abstract
概要
This document describes detailed Input/Output parameters for the Internet Open Trading Protocol (IOTP) Payment Application Programming Interface (API). It also describes procedures in the Payment Bridge for the use of SET (SET Secure Electronic Transaction) as the payment protocol within Version 1.0 of the IOTP.
このドキュメントでは、インターネットオープントレーディングプロトコル(IOTP)支払いアプリケーションプログラミングインターフェイス(API)の詳細な入出力パラメーターについて説明します。また、IOTPのバージョン1.0内の支払いプロトコルとして、セット(Set Secure Electronic Transaction)を使用するための支払いブリッジの手順についても説明しています。
Table of Contents
目次
1. Introduction....................................................3 1.1 Objectives of this Document.................................3 1.2 Scope of this specification.................................3 1.2.1 The version of IOTP specification.....................3 1.2.2 The version of SET specification......................4 1.2.3 The version of IOTP Architecture document.............4 1.3 Audience....................................................4 1.4 Notation....................................................4 1.5 Terminology.................................................4 2. Requirements & Development Policy...............................4 3. Business Models.................................................5 3.1 Entity models between SET and IOTP..........................5 3.2 Role of Participants........................................5 3.3 Scope of Transaction Types..................................6 3.4 Types of transaction not in scope...........................6 4. Architecture of SET/IOTP........................................7 5. Trading Types of SET/IOTP.......................................7 5.1 Baseline Purchase...........................................7 5.2 Cash Advances...............................................8 5.3 Status Inquiry .............................................8
6. General Flow of SET/IOTP........................................8 6.1 Baseline Purchase...........................................9 6.1.1 Brand Independent Baseline Purchase...................9 6.1.2 Brand Dependent Baseline Purchase....................13 6.2 Cash Advances..............................................14 6.3 Status Inquiry.............................................15 7. IOTP Payment APIs..............................................16 7.1 Brand Compilation Related API Calls........................16 7.1.1 Find Accepted Payment Brand..........................16 7.1.2 Find Accepted Payment Protocol.......................17 7.1.3 Get Payment Initialization Data......................18 7.1.4 Inquire Authentication Challenge.....................19 7.1.5 Authenticate.........................................19 7.1.6 Check Authentication Response........................19 7.2 Brand Selection Related API Calls..........................20 7.2.1 Find Payment Instrument..............................20 7.2.2 Check Payment Possibility............................21 7.3 Payment Transaction Related API Calls......................22 7.3.1 Start Payment Consumer...............................22 7.3.2 Start Payment Payment Handler........................23 7.3.3 Resume Payment Consumer..............................24 7.3.4 Continue Process.....................................25 7.3.5. Change Process State................................26 7.4 General Inquiry API Calls..................................26 7.4.1 Payment Instrument Inquiry...........................26 7.4.2 Inquire Pending Payment..............................26 7.4.3 Remove Payment Log...................................27 7.5 Payment Related Inquiry API Calls..........................27 7.5.1 Check Payment Receipt................................27 7.5.2 Expand Payment Receipt...............................27 7.5.3 Inquire Process State................................28 7.5.4 Start Payment Inquiry................................29 7.5.5 Inquire Payment Status...............................30 8. SET dependent Process..........................................30 8.1 Relationships between them for IOTP Purchase/Cash Advances.30 8.2 Definition of Identifiers..................................31 8.2.1 Definition of BrandId................................31 8.2.2 Definition of ProtocolBrandId........................31 8.2.3 Definition of ProtocolId.............................33 8.2.4 Relationship between Ids.............................33 8.3 Process prior to Payment...................................34 8.3.1 FindAcceptedPaymentProtocol Function.................34 8.3.2 FindPaymentInstrument Function.......................35 8.3.3 GetPaymentInitializationData Function................36 8.4 Process of Payment.........................................37 8.4.1 StartPaymentConsumer Function........................37 8.4.2 StartPaymentPaymentHandler Function..................41 8.4.3 ContinueProcess Function (Consumer Side).............42 8.4.4 ContinueProcess Function (Payment Handler Side)......43 8.4.5 InquireProcessState Function.........................45 8.5 Payment Receipt............................................45 8.5.1 CheckPayReceipt Function.............................45 8.5.2 ExpandPayReceipt Function............................45 8.6 Status Inquiry.............................................46 8.7 Resume Process.............................................47 8.8 SET Scheme Specific Authentication on IOTP.................47 8.9 SET Bridge ProcessState....................................48 8.9.1 SET Bridge ProcessState of Consumer..................48 8.9.2 SET Bridge ProcessState of Payment Handler...........49 8.10 Relationship between Pay Step and Deliv Step on SET/IOTP..49 8.11 Completion Code...........................................50 8.12 PercentComplete...........................................50 8.13 Severity..................................................51 9. Error Handling.................................................51 9.1 Types of Errors............................................51 9.2 IOTP Level Error (OAC Error)...............................52 9.3 IOTP Level Error (SET Bridge Error)........................52 9.4 SET Level Error (SET Technical Error)......................52 9.4.1 SET Initiation Error.................................52 9.4.2 SET Transaction Error................................53 9.5 SET Level Error (SET Business Error).......................53 10. Security Considerations.......................................54 11. References....................................................54 12. IANA Considerations...........................................55 13. Acknowledgement...............................................55 14. Author's Address..............................................55 15. Full Copyright Statement......................................56
This chapter describes the outline of this document.
この章では、このドキュメントの概要について説明します。
This document describes how SET (SET Secure Electronic Transaction) works within the IOTP (Internet Open Trading Protocol).
このドキュメントでは、IOTP(インターネットオープントレーディングプロトコル)内でセット(セットセット電子トランザクション)がどのように機能するかについて説明します。
This document is written based on IOTP Version 1.0 [RFC 2801].
このドキュメントは、IOTPバージョン1.0 [RFC 2801]に基づいて書かれています。
This document is written based on SET Version 1.0 [SET].
このドキュメントは、セットバージョン1.0 [セット]に基づいて記述されています。
This document is written based on IOTP Payment API document Version 1.0 [IOTP Payment API].
このドキュメントは、IOTP支払いAPIドキュメントバージョン1.0 [IOTP支払いAPI]に基づいて書かれています。
This document is indented for readers who are familiar with the following documents:
このドキュメントは、次のドキュメントに精通している読者のためにインデントされています。
1) IOTP Specification Version 1.0 [RFC 2801] 2) SET Specification, in particular Book 2:Programmer's Guide and Book3:Formal Protocol Definition, 3) External Interface Guide to SET Secure Electronic Transaction 4) Internet Open Trading Supplement: Architecture and Payment API [IOTP API]
1) IOTP仕様バージョン1.0 [RFC 2801] 2)仕様の設定、特に本2:プログラマーズガイドとブック3:正式なプロトコル定義、3)セット電子トランザクションを設定するための外部インターフェイスガイド4)インターネットオープントレーディングサプリメント:アーキテクチャと支払いAPI [IOTPAPI]
SET Messages and Elements are described with the prefix "SET".
設定メッセージと要素は、プレフィックス「セット」で説明されています。
Examples: SET PRes SET OD SET SaleDetail
例:セットセットセールの詳細を設定します
This document uses the following terms:
このドキュメントでは、次の用語を使用しています。
SET/IOTP The specification described in this document. SET related message Both SET Messages and SET Initiation Messages
このドキュメントで説明されている仕様をset/iotp。関連するメッセージの設定メッセージと開始メッセージの設定の両方
This chapter describes the requirements and development policies of SET/IOTP.
この章では、Set/IoTPの要件と開発ポリシーについて説明します。
The requirements of SET/IOTP are as follows:
set/ioTPの要件は次のとおりです。
o To be based on SET specifications. Interoperability at the payment level must be maintained.
o 設定仕様に基づく。支払いレベルでの相互運用性を維持する必要があります。
o To not enforce modifications which are specific to SET/IOTP. General features of IOTP should not be tampered with to cater to a particular payment method.
o set/iotpに固有の変更を強制しないこと。IOTPの一般的な機能は、特定の支払い方法に応えるために改ざんすべきではありません。
o To keep integrity between IOTP and SET. Inconstancy must not be raised between IOTP and SET elements when they have the same meaning.
o IOTPとセットの間の完全性を維持するため。IOTPと設定要素が同じ意味を持っている場合、IoTPと設定された要素の間で不整合を引き上げてはなりません。
The development policy of SET/IOTP is as follows:
Set/IoTPの開発ポリシーは次のとおりです。
o To minimize the number of message round trips
o メッセージラウンドトリップの数を最小限に抑えるため
o To minimize the length of messages
o メッセージの長さを最小限に抑えるため
This chapter describes the difference in entity models between SET and IOTP, the definitions of Trading Roles in SET/IOTP, and the scope of SET/IOTP.
この章では、SETとIOTPの間のエンティティモデルの違い、SET/IOTPでの取引役割の定義、およびSET/IOTPの範囲について説明します。
The following table describes how SET and IOTP entities correspond to each other.
次の表は、セットとIOTPエンティティがどのように互いに対応するかを説明しています。
| IOTP Entity SET Entity | | ------------------------------------------------ | | Consumer <---> Card Holder | | Merchant <---> Merchant (Initiation) | | Payment Handler <---> Merchant (Payment) | | Delivery Handler<---> None | | None <---> Acquirer |
Figure 1 Entity Models between SET and IOTP
図1セットとIOTPの間のエンティティモデル
The following table describes the trading roles in SET/IOTP.
次の表は、Set/IoTPの取引役割について説明しています。
Trading Roles Role ------------------------------------------------------------- Consumer An Individual who purchases goods and/or services, and pays for the value received by choosing a SET Transaction. This individual corresponds with the CardHolder in SET.
Merchant An organization that provides goods and/or services for purchase, accepts payment methods, delivers invoices and triggers payment processes.
商人購入のために商品やサービスを提供し、支払い方法を受け入れ、請求書を提供し、支払いプロセスをトリガーする組織。
Payment Handler An organization that processes negotiations on payments including SET payment transactions.
支払いハンドラーセット支払い取引を含む支払いに関する交渉を処理する組織。
Delivery Handler An Organization that ships digital or physical goods to the Consumer.
配信ハンドラー消費者にデジタルまたは物理的な商品を出荷する組織。
Customer Care The same as in [RFC 2801]. Provider
[RFC 2801]と同じカスタマーケア。プロバイダー
Merchant Care The same as in [RFC 2801]. Provider
[RFC 2801]と同じマーチャントケア。プロバイダー
The types of IOTP transactions that are supported in this document are as follows:
このドキュメントでサポートされているIOTPトランザクションの種類は次のとおりです。
o Brand Independent Baseline Purchase when SET is used for payment
o セットが支払いに使用されたときのブランド独立したベースライン購入
o Brand Dependent Baseline Purchase when SET is used for payment
o セットが支払いに使用されるときのブランド依存ベースライン購入
o Cash Advances (Brand Independent and Brand Dependent case)
o キャッシュアドバンス(ブランド独立およびブランドに依存するケース)
o Status Inquiry on SET payments
o 設定支払いに関するステータス照会
The types of transactions that are NOT covered in this document are as follows:
このドキュメントでカバーされていないトランザクションの種類は次のとおりです。
o Credit Reversal Process
o クレジット逆転プロセス
o Customer Care Service with Consumer Related SET Certificate Registration
o 消費者関連のセット証明書登録を備えたカスタマーケアサービス
o Customer Care Service with Consumer Related SET Certificate Registration Inquiry
o 消費者関連セット証明書登録照会によるカスタマーケアサービス
SET/IOTP Architecture is as follows:
セット/IOTPアーキテクチャは次のとおりです。
IOTP client (Consumer) <---------------> IOTP server (Merchant) ^ Internet ^ | IOTP Payment | IOTP Payment | API | API v v IOTP/Payment Bridge IOTP/Payment Bridge ^ ^ | Existing Payment APIs, e.g., | | SET, Mondex, etc. | v v Existing Payment Software Existing Payment Software
Figure 2 SET/IOTP Architecture
図2セット/IOTPアーキテクチャ
IOTP Application Core (OAC): Software that processes IOTP messages. IOTP Payment Bridge (OPB): Interface between OAC and Existing Payment Software. SET Bridge is also an interface between OAC and SET Core.
IOTPアプリケーションコア(OAC):IOTPメッセージを処理するソフトウェア。IOTP支払いブリッジ(OPB):OACと既存の支払いソフトウェアとの間のインターフェイス。Set Bridgeは、OACとSet Coreの間のインターフェースでもあります。
Existing Payment Software (EPS): Existing Software that processes Payments. The SET Core is software that supports mechanisms in SET specification from Book1 to Book3. EPS does NOT necessarily have to implement the SET Initiation Processor, which is specified in SET EIG. SET Related Module Both SET related OPB and EPS.
既存の支払いソフトウェア(EPS):支払いを処理する既存のソフトウェア。セットコアは、book1からbook3までのセット仕様のメカニズムをサポートするソフトウェアです。EPSは、SET EIGで指定されているSET開始プロセッサを必ずしも実装する必要はありません。関連するモジュールの両方が関連するOPBとEPSの両方を設定します。
This chapter describes the outline of SET/IOTP trading types.
この章では、SET/IOTP取引タイプの概要について説明します。
Three steps will take place in a Baseline Purchase in the following order:
ベースライン購入で次の順序で3つのステップが行われます。
(1) Offer Step
(1) オファーステップ
Consumer selects goods/services over the Internet, for instance on the web, and then chooses the payment method (SET is selected), the SET brand, the payment currency, and then confirms the invoice.
消費者は、たとえばWeb上でインターネットで商品/サービスを選択し、支払い方法(セットが選択されている)、セットブランド、支払い通貨を選択し、請求書を確認します。
There are two Offer Process types, Brand Independent and Brand Dependent.
ブランド独立とブランド依存の2つのオファープロセスタイプがあります。
(1-a) Brand Independent Purchase
(1-A)ブランド独立した購入
In a Brand Independent Purchase, the Merchant sends the TPO Block and Offer Response Block simultaneously after the consumer's purchase decision. The Brand Independent Purchase has the merit of eliminating one round of messages compared with the Brand Dependent Purchase because the contents of the Offer Response Block (for example, the description on the invoice) do not change based on the selected brand.
ブランド独立した購入では、マーチャントはTPOブロックを送信し、消費者の購入決定の後に同時に応答ブロックを提供します。ブランド独立した購入は、オファー応答ブロックの内容(請求書の説明など)のコンテンツが選択されたブランドに基づいて変更されないため、ブランド依存の購入と比較して1ラウンドのメッセージを排除するメリットがあります。
(1-b) Brand Dependent Purchase
(1-B)ブランド依存の購入
Brand Dependent Purchase is used when the contents of the Offer Response Block are dependent on the selected Payment Brand. With this method, the currency selection and discounts based on payment method can be implemented.
オファー応答ブロックの内容が選択された支払いブランドに依存している場合、ブランド依存の購入が使用されます。この方法では、支払い方法に基づく通貨の選択と割引を実装できます。
(2) Payment Step
(2) 支払いステップ
The Consumer confirms the order and then pays for the order with a SET Transaction. The SET Transaction messages will be encapsulated in IOTP Messages.
消費者は注文を確認し、セットトランザクションで注文を支払います。設定されたトランザクションメッセージは、IOTPメッセージにカプセル化されます。
(3) Delivery Step
(3) 配達ステップ
After completing the Payment, the Consumer receives the goods/services via either on-line or physical delivery.
支払いを完了した後、消費者はオンラインまたは物理的な配達のいずれかを介して商品/サービスを受け取ります。
Cash Advances can be made via a Value Exchange Transaction in IOTP. A first Payment by SET and a second Payment by some other payment mechanism is supported in Baseline IOTP. The Cash Advance has two types - Brand Independent and Brand Dependent Cases.
キャッシュアドバンスは、IOTPでの価値交換トランザクションを介して行うことができます。セットによる最初の支払いと、他のいくつかの支払いメカニズムによる2回目の支払いは、ベースラインIOTPでサポートされています。キャッシュアドバンスには、ブランド独立とブランドに依存するケースの2つのタイプがあります。
A Consumer can send a SET Payment Inquiry in IOTP. The SET Message is encapsulated in an IOTP Message.
消費者はIOTPでセット支払い照会を送信できます。セットメッセージは、IOTPメッセージにカプセル化されています。
This chapter illustrates the general SET/IOTP message flows.
この章では、一般的なセット/IOTPメッセージフローを示しています。
Baseline purchases consist of two types, Brand Independent Purchase and Brand Dependent Purchase. Each type is illustrated in the charts below.
ベースラインの購入は、ブランド独立した購入とブランド依存の購入という2つのタイプで構成されています。各タイプは、以下のチャートに示されています。
The general flow of a Brand Independent Purchase is as follows:
ブランド独立した購入の一般的な流れは次のとおりです。
(1) Consumer Side (Before PayRequest Message)
(1) 消費者側(PayRequestメッセージの前)
SET Core SET Bridge OAC | | | TPO & OfferResp message | | |<------------------- From | |<------------| Merchant | | FindPayment | | | Instrument| | |------------>| | | Response | | |<------------| | | CheckPayment| | | Possibility| | |------------>| | | Response | | |<------------| |<------------| StartPayment| |------------>| Consumer| | |------------>| PayRequest Message | | Response |-------------------> To Payment (SET Init Resp/ Handler SET PInitReq)
Figure 3 Consumer Side for Brand Independent (1)
図3ブランド独立の消費者側(1)
(2) Consumer Side (After PayRequest Message)
(2) 消費者側(PayRequestメッセージの後)
SET Core SET Bridge OAC | | | Pay Exch Message | | |<------------------- From | SET PInitRes|<------------| (SET PInitRes) P.H. |<------------| Continue | |------------>| Process | | SET PReq |------------>| Pay Exch Message | | Response |-------------------> To P.H. | | | (SET PReq) | | | Pay Exch Message | | |<------------------ From P.H. | SET PRes |<------------| (SET PRes) |<------------| Continue | |------------>| Process | | |------------>| | |Response[END]| | |<------------| | | CheckPayment| | | Receipt | | |------------>| | | Response | | |<------------| | |ExpandPayment| | | Receipt | | |------------>| | | Response | | |<------------| | |ChangeProcess| | | State | | |------------>| | | Response |
Figure 4 Consumer Side flow for Brand Independent (2)
図4ブランド独立の消費者サイドフロー(2)
(3) Merchant Side
(3) 商人側
OAC SET Bridge |--------------->| |FindAccepted | | PaymentBrand | |<---------------| | Response | |--------------->| |FindAccepted | | PaymentProtocol| |<---------------| | Response | |--------------->| |GetPaymentInit- | | lizationData | TPO & Offer Resp Msg. |<---------------| <------------------------| Response | To Consumer
Figure 5 Merchant Side flow for Brand Independent
図5ブランド独立のためのマーチャントサイドフロー
(4) Payment Handler Side.
(4) 支払いハンドラー側。
OAC SET Bridge SET Core PayRequest Message | | | From ---------------------->| | | Consumer (SET Init Res/ |--------------->| | SET PInitReq) |StartPayment |------------>| | PaymentHandler |<------------| PayExch Message |<---------------| | To <----------------------| Response | | Consumer (SET Init Req/ . . . SET PInitRes) . . . PayExch Mssage | | | ---------------------->| | | From Consumer (SET PReq) |--------------->| SET PReq | | Continue |------------>| | Process |<------------| |<---------------| SET PRes | | Response | | |--------------->| | | Inquire | | | ProcessState | | |<---------------| | | Response | | |--------------->| | | ChangeProcess | | | State | | PayResponse Message |<---------------| | <------------------------| Response | | To Consumer (SET PRes)
Figure 6 Payment Handler side flow for Brand Independent
図6ブランド独立の支払いハンドラーサイドフロー
The general flow of a Brand Dependent Purchase is as follows:
ブランドに依存する購入の一般的な流れは次のとおりです。
(1) Consumer Side (Before PayRequest Message)
(1) 消費者側(PayRequestメッセージの前)
SET Core SET Bridge OAC | | | TPO message | | |<------------------- From | |<------------| Merchant | | FindPayment | | | Instrument| | |------------>| | | Response | | |<------------| | | CheckPayment| | | Possibility| | |------------>| TPO Selection Msg. | | Response |-------------------> To Merchant | | |<------------------ From Merchant | |<------------| Offer Response Msg. |<------------| StartPayment| |------------>| Consumer| | |------------>| PayRequest Message | | Response |-------------------> To Payment (SET Init Resp/ Handler SET PInitReq)
Figure 7 Consumer Side flow for Brand Dependent (1)
図7ブランド依存の消費者サイドフロー(1)
(2) Consumer Side (After PayRequest Message)
(2) 消費者側(PayRequestメッセージの後)
This flow is the same as Brand Independent.
このフローは、Brand Independentと同じです。
(3) Merchant Side
(3) 商人側
OAC SET Bridge |--------------->| |FindAccepted | | PaymentBrand | |<---------------| | Response | |--------------->| |FindAccepted | | PaymentProtocol| TPO Message |<---------------| <------------------------| Response | To Consumer | | TPO Selection Message | | ------------------------>| | From Consumer |--------------->| |GetPaymentInit- | | lizationData | Offer Response Message |<---------------| <------------------------| Response | To Consumer
Figure 8 Merchant Side flow for Brand Dependent (1)
図8ブランド依存の商人サイドフロー(1)
(4) Payment Handler Side
(4) 支払いハンドラー側
This flow is the same as Brand Independent.
このフローは、Brand Independentと同じです。
IOTP Cash Advances processes can be made with a credit card using an IOTP Value Exchange Transaction. In Cash Advances a first Payment by a SET Transaction, and a second Payment by some other payment mechanism, is supported in Baseline IOTP. The general flow is omitted.
IOTPキャッシュアドバンスプロセスは、IOTP Value Exchangeトランザクションを使用してクレジットカードで作成できます。キャッシュアドバンスでは、セット取引による最初の支払い、および他のいくつかの支払いメカニズムによる2回目の支払いがベースラインIOTPでサポートされています。一般的なフローは省略されています。
The general flow of a Status Inquiry is as follows:
ステータス照会の一般的な流れは次のとおりです。
(1) Consumer Side
(1) 消費者側
SET Core SET Bridge OAC | | | | | | | |<------------| |<------------| StartPayment| |------------>| Inquiry| | SET InqReq |------------>| Inquiry Request | | Response |-------------------> To P.H. | | | (SET InqReq) | | | | | | Inquiry Response | | |<------------------- From P.H. | | | (SET InqRes) | SET Inq Res |<------------| |<------------| Continue | |------------>| Process| | SET InqReq |------------>| | | [End] | | |ChangeProcess| | | State| | |<------------| |<------------|
Figure 9 Consumer Side flow for Status Inquiry
図9ステータス照会の消費者サイドフロー
(2) Payment Handler Side
(2) 支払いハンドラー側
OAC SET Bridge SET Core InquiryReq message | | | From ------------------------>| | | Consumer (SET InqReq) |------------->| | |InquirePayment|------------>| | Status| SET InqReq | | |<------------| | | SET InqRes | InquiryResp message |<-------------| | To <------------------------| Response | | Consumer (SET InqRes) |
Figure 10 Payment Handler Side flow for Status Inquiry
図10ステータス照会のための支払いハンドラーサイドフロー
This section provides a summary of SET/IOTP interactions with API calls as in [IOTP Payment API].
このセクションでは、[IOTP支払いAPI]のように、API呼び出しとのSET/IOTP相互作用の概要を示します。
The description of parameters hereafter are written as follows:
以下のパラメーターの説明は、次のように書かれています。
Parameter name : Mandatory (M) or Optional (O) : Description
パラメーター名:必須(m)またはオプション(o):説明
For more details on the IOTP Payment APIs, see [IOTP Payment API]. "-" in the Description is the same as description in the [IOTP Payment API].
IOTP支払いAPIの詳細については、[IOTP支払いAPI]を参照してください。「 - 」の説明は、[IOTP支払いAPI]の説明と同じです。
Notice: Status is the status of SET/IOTP. Though some Fields are specified "#IMPLIED" in [IOTP Payment API], if the fields must be used in SET/IOTP, this document specifies the status as Mandatory, (M).
通知:ステータスはSET/IOTPのステータスです。一部のフィールドは[IOTP支払いAPI]で「#Implied」で指定されていますが、フィールドをSET/IOTPで使用する必要がある場合、このドキュメントは必須としてステータスを指定します(m)。
Receive the payment scheme specific packaged data to generate Brand Component. In this version of SET/IOTP, This API must be called before Find Accepted Payment Protocol function.
支払いスキーム固有のパッケージデータを受信して、ブランドコンポーネントを生成します。Set/IOTPのこのバージョンでは、受け入れられた支払いプロトコル関数を見つける前に、このAPIを呼び出す必要があります。
Input Parameters ---------------- PayDirection : M : This must be set "Debit". CurrCodeType : M : This should be set "ISO4217-A". CurrCode : M : - Amount : M : - MerchantPayId : M : - MerchantOrgId : M : - WalletId : O : - MerchantData : O : The details are not specified in this document. Output Parameters ----------------- BrandItem : M : See NOTE below.
NOTE: Parameters of BrandItem ----------------------------- BrandId : M : This is defined in the section 8.2.1. xml:lang : M : - BrandName : M : Brand Name, such as "MasterCard". BrandLogoNetLocn : M : - BrandNarrative : O : This is not specified in this document. BrandPackaged : O : This is not used in the SET/IOTP. Content
Receive the payment scheme specific packaged data to generate the PayProtocol Component.
PayProtocolコンポーネントを生成するために、支払いスキーム固有のパッケージデータを受信します。
Input Parameters ---------------- BrandId : M : This is defined in the section 8.2.1. PayDirection : M : This must be set "Debit". CurrCodeType : M : This should be set "ISO4217-A". CurrCode : M : - Amount : M : - MerhcantPayId : M : - MercahntOrgId : M : - WalletId : O : - BrandPackaged : O : This is not used in the SET/IOTP. Content MerchantData : O : This is not specified in the SET/IOTP.
Output Parameters ----------------- ProtocolItem : M : See NOTE below. BrandItem : M : -
NOTE Parameters of ProtocolItem ------------------------------- ProtocolId : M : This is set "SETv1.0". ProtocolBrandId : M : This is set the Payment Protocol Specific ID corresponding to the BrandId as Input Parameter and ProtocolId as the Output Parameter. For the detail, see 8.2.2. xml:lang : M : - ProtocolName : M : This is not specified in this document but must be included the protocol name and its version at least.
PayReqNetLocn : O : The Net Location indicating where a unsecured Payment Request Message should be sent if this protocol choice is used. SecPayReqNetLocn : O : The Net Location indicating where a secured Payment Request Message should be sent if this protocol choice is used. ProtocolAmount : O : This is not used in the SET/IOTP. PackagedContent PayProtocol : M : The XML Packaged Data, which includes PackagedContent the information for the 1st SET Initiation Process. See for the details to section 8.3.1. Brand : M : In this document, BrandId, which is the same as Input Parameter,must be set ONLY. See NOTE below. CurrencyAmount : M : See NOTE below. ProtocolBrand : M : Multiple Components are not arrowed in the current version of SET/IOTP.
Payreqnetlocn:o:このプロトコルの選択が使用されている場合、無担保支払い要求メッセージを送信する場所を示すネットロケーション。SecPayReqNetLocn:O:このプロトコルの選択を使用する場合、保護された支払い要求メッセージを送信する場所を示すネットロケーション。Protocolamount:o:これは、set/iotpでは使用されていません。PackagedContent PayProtocol:M:XMLパッケージデータ。これには、パッケージ化されたコンテンントが含まれています。セクション8.3.1の詳細については、参照してください。ブランド:M:このドキュメントでは、入力パラメーターと同じBrandidを設定する必要があります。以下のメモを参照してください。CurrencyMount:M:以下の注を参照してください。Protocolbrand:M:複数のコンポーネントは、Set/IOTPの現在のバージョンでは矢印ではありません。
Note Parameters of CurrencyAmount --------------------------------- CurrCodeType : M : This should be set "ISO4217-A". CurrCode : M : - Amount : M : -
Note Parameters of Brand ------------------------ BrandId : M : -
This API is used to get the packaged content in Payment Component.
このAPIは、支払いコンポーネントでパッケージ化されたコンテンツを取得するために使用されます。
Input Parameters ---------------- BrandId : M : See the details of section 8.2.1. MerchantPayId : M : - PayDirection : M : This is set "Debit". CurrCodeType : M : This is set "ISO5217-A". CurrCode : M : - Amount : M : - OkFrom : M : - OkTo : M : - ReceiverOrgId : M : Organization ID which is used to get TradingRolePackagedContents, which depend on the organizations for each. MerchantOrgId : M : - ProtocolId : M : This field must be set "SETv1.0". WalletId : O : - PassPhrase : O : - ProtocolBrand : M : - BrandPackaged : O : This is not used in the current version Content of SET/IOTP. ProtocolAmount : O : This is not used in the current version PackagedContent of SET/IOTP. PayProtocolPackaged: M : This field is copied from the Content PayProtocol Component. OrderPackaged : M : Packaged Data regarding the Order data, Content which the Merchant's OAC sets. BrandSelBrandInfo : O : This is not used in the current PackagedContent version of SET/IOTP. BrandSelProtocol : O : This is not used in the AmountInfoPackaged current version of SET/IOTP. Content BrandSelCurrency : O : This is not used in the AmountInfo current version of SET/IOTP. PackagedContent
Output Parameters ----------------- OkFrom : M : - OkTo : M : - OrderPackaged : M :Changed OrderPackagedContent if Content it rewrites the order information. Otherwise, passed the same input data to OAC. TradingRole : O : The receiver depended PackagedContent TradingRolePackagedContent. The Name Attribute of the packaged contents must include "Payment:" as the prefix, for example "Payment:SET-OD". Multiple TradingRoleData may be returned.
This is not used in the current version of SET/IOTP.
これは、set/iotpの現在のバージョンでは使用されません。
This is not used in the current version of SET/IOTP.
これは、set/iotpの現在のバージョンでは使用されません。
This is not used in the current version of SET/IOTP.
これは、set/iotpの現在のバージョンでは使用されません。
This API is used to get the Payment Instruments that can be accepted by the Payment Handler on behalf of the Merchant.
このAPIは、商人に代わって支払いハンドラーが受け入れることができる支払い手段を取得するために使用されます。
Input Parameters ---------------- BrandId : M : See the details of section 8.2.2. ProtocolId : M : This must be set "SETv1.0". PayDirection : M : This must be set "Debit". CurrCodeType : M : This should be set "ISO5217-A". CurrCode : M : - Amount : M : - ConsumerPayId : M : - WalletId : O : - ProtocolBrand : M : - BrandPackaged : O : This is not used in the current Content version of SET/IOTP. ProtocolAmount : O : This is not used in the current PackagedContent version of SET/IOTP. PayProtocolPackaged: M : See details for section 8.3.1. Content
Output Parameters ----------------- PayInstrument : M : Multiple PayInstrument Ids may be returned. See NOTE below.
NOTE Parameters of PayInstrument -------------------------------- Id : M : This must be unique each SET Certificates which the Consumer can use. xml:lang : M : - PayInstName : M : -
If the SET Bridge receives this API Message, the SET Bridge returns three packaged content fields.
セットブリッジがこのAPIメッセージを受信すると、セットブリッジは3つのパッケージ化されたコンテンツフィールドを返します。
Input Parameters ---------------- BrandId : M : This is set the consumer selected BrandId. PaymentInstrumentId: M : This is set the consumer selected PaymentInstrumentID. PayDirection : M : This is set "Debit". CurrCodeType : M : This is set "ISO4217-A". CurrCode : M : - Amount : M : - ProtocolId : M : This must be set "SETv1.0". WalletId : O : - Passphrase : O : - ConsumerPayId : M : - ProtocolBrand : M : This is set the consumer selected ProtocolBrand Component. BrandPackaged : O : This is not used in the current Content version of SET/IOTP. ProtocolAmount : O : This is not used in the current PackagedContent version of SET/IOTP. PayProtocol : M : This field is copied from the PayProtocol PackagedContent Component
Output Parameter --------------- BrandSelBrandInfo : O : This is not used in the current PackagedContent version of SET/IOTP. BrandSelProtocol : O : This is not used in the AmountInfoPackaged current version of SET/IOTP. Content
BrandSelCurrency : O : This is not used in the AmountInfoPackaged current version of SET/IOTP. Content
BrandselCurrency:o:これは、set/iotpの額面バージョンでは使用されていません。コンテンツ
In SET/IOTP, this API is used for the Consumer's SET Bridge to process the 1st SET Initiation and any subsequent SET messages.
SET/IOTPでは、このAPIは、消費者のセットブリッジに使用され、最初のセット開始とその後のセットメッセージを処理します。
Input Parameters ---------------- BrandId : M : ID for the consumer selected Brand. See the details of section 8.2.1. PaymentInstrumentId: M : ID for the consumer selected Instrument. CurrCodeType : M : The consumer selected CurrCodeType. CurrCode : M : The consumer selected CurrCode. Amount : M : The consumer selected Amount. PayDirection : M : Indicates the payment direction from the Consumer's prospective. ProtocolId : M : The consumer selected ProtocolId. OkFrom : M : - OkTo : M : - ConsumerPayId : M : - WalletID : O : - Passphrase : O : - CallBackFunction : O : This is not used in the SET/IOTP. CallBackLanguage : O : This is not used in the SET/IOTP. List ProtocolBrand : M : ID for the consumer selected Protocol dependent Brand information. BrandPackaged : O : This is not used in the current Content version of SET/IOTP. ProtocolAmount : O : This is not used in the current PackagedContent version of SET/IOTP. PayProtocolPackaged : M : See section 8.2.2. Content
Output Parameters ----------------- ContStatus : M : "Continue" must be set if there is in no problem PaySchemePackaged : M : See section 6.5.1. Content
This API is used to initiate a payment on the Payment Handler's side. The SET Related Module does a payment initialization. The SET Related Module processes SET Message received and returns the appropriate SET Message (e.g., 2nd SET Initiation or SET PinitRes message).
このAPIは、支払いハンドラーの側で支払いを開始するために使用されます。セット関連のモジュールは、支払い初期化を行います。セット関連のモジュールプロセスは、受信したメッセージのセットメッセージをプロセスし、適切なセットメッセージ(例:2番目のセット開始またはセットピニトレメッセージ)を返します。
Input Parameters ---------------- BrandId : M : ID for the consumer selected Brand. See the details of section 8.2.1. ConsumerPayId : O : ID for the consumer generated payment transaction. CurrCodeType : M : The consumer selected CurrCodeType. This should be set "ISO4217-A". CurrCode : M : The consumer selected CurrCode. Amount : M : The consumer selected Amount. PayDirection : M : This is set "Debit". ProtocolId : M : The consumer selected ProtocolId. This must be set "SETv1.0". OkFrom: : M : - OkTo : M : - PaymentHandlerPayId: M : - MerchantOrgId : M : - WalletID : O : - Passphrase : O : - CallBackFunction : O : This is not used in the SET/IOTP. CallBackLanguage : O : This is not used in the SET/IOTP. List BrandPackaged : O : This is not used in the current Content version of SET/IOTP. ProtocolAmountP : O : This is not used in the current PackagedContent version of SET/IOTP. PayProtocolPackaged: M : - Content ProtocolBrand : M : Information for the consumer selected Protocol dependent Brand. BrandSelBrandInfo : O : This is not used in the current PackagedContent version of SET/IOTP. BrandSelProtocol : O : This is not used in the AmountInfo current version of SET/IOTP. PackagedContent BrandSelCurrency : O : This is not used in the AmountInfo current version of SET/IOTP. PackagedContent
TradingRolePackaged: O : Copied from the TradingRoleData Content Component. The Name Attribute of the packaged contents must include "Payment:" as the prefix, for example "Payment:SET-OD". PaySchemePackaged : M : See section 6.5.2. Content
TradingRolePackaged:O:TradingroleDataコンテンツコンポーネントからコピー。パッケージ化されたコンテンツの名前属性には、「支払い:」をプレフィックスとして含める必要があります。たとえば、「支払い:set-od」です。Payschemepackaged:M:セクション6.5.2を参照してください。コンテンツ
Output Parameters ----------------- PaySchemePackaged : M : See section 6.5.2. Content ContStatus : M : "Continue" must be set if there is no problem.
This API is used to restart a payment transaction when the transaction is suspended for some reason such as a time out. The last SET Message relevant to this suspended transaction is returned as the Response.
このAPIは、タイムアウトなど、何らかの理由でトランザクションが停止されたときに支払いトランザクションを再起動するために使用されます。この中断されたトランザクションに関連する最後のセットメッセージは、応答として返されます。
Input Parameters ---------------- ConsumerPayId : M : - WalletId : O : - PassPhrase : O : - CallBackFunction : O : This is not used in the current version of SET/IOTP. CallBack : O : This is not used in the current version LanguageList of SET/IOTP.
Output Parameters ----------------- ContStatus : M : - PaySchamePackaged : M : See section 8.7. Content
This API is used to pass a SET related message, received from the counter party, to the SET Bridge, and accept the next SET message as a response.
このAPIは、セット関連のメッセージをカウンターパーティからセットブリッジに渡し、次のセットメッセージを応答として受け入れるために使用されます。
(1) Consumer Side Payment Bridge
(1) 消費者側の支払いブリッジ
Input Parameters ---------------- PayId : M : Set ConsumerPayId WalletId : O : - PassPhrase : O : - PaySchemePackaged : M : See section 8.4.3. Content
Output Parameters ----------------- ContStatus : M : Set "End" if SET PRes message is received in the PaySchemePackagedContent as the input parameter, otherwise set "Continue". PaySchemePackaged : O : If ContStatus is set "End", this is not Content used. See 8.4.3.
(2) Payment Handler Side Payment Bridge
(2) 支払いハンドラー側の支払いブリッジ
Input Parameters ---------------- PayId : M : Set PaymentHandlerPayId WalletId : O : - PassPhrase : O : - PaySchemePackaged : M : See section 8.4.4. Content
Output Parameters ----------------- ContStatus : M : Set "End" if SET PRes message is received in the PaySchemePackagedContent as the output parameter, otherwise set "Continue". PaySchemePackaged : M : See section 8.4.4. Content
This API is used by the OAC to change the Process State of the OPB. For instance, it is used to change the Payment Status after a SET Payment Transaction was completed. When an error or suspend happens, this API is also used.
このAPIは、OACによってOPBのプロセス状態を変更するために使用されます。たとえば、設定された支払いトランザクションが完了した後、支払いステータスを変更するために使用されます。エラーまたは一時停止が発生すると、このAPIも使用されます。
(1) Consumer Side Payment Bridge
(1) 消費者側の支払いブリッジ
Input Parameters ---------------- PayId : M : Set ConsumerPayId ProcessState : M : - CompletionCode : M : - ProcessType : M : - WalletID : O : - PassPhrase : O : -
Output Parameters ----------------- ProcessState : M : - CompletionCode : M : - PercentComplete : O : See section 8.13. xml:lang : O : - StatusDesc : O : This field is not specified in SET/IOTP.
This API is not used in the current version of SET/IOTP.
このAPIは、Set/IOTPの現在のバージョンでは使用されていません。
This API is used to check whether the payment Bridge or its wallet is currently in use, or not.
このAPIは、支払いブリッジまたはそのウォレットが現在使用されているかどうかを確認するために使用されます。
Input Parameters ---------------- WalletID : O : -
Output Parameters ----------------- PayId : M : -
This API is used both Consumer and Payment Handler.
このAPIは、消費者と支払いハンドラーの両方を使用しています。
Input Parameters ---------------- PayId : M : - WallerId : O : - Passphrase : O : -
There is no output parameters.
出力パラメーターはありません。
This API is used to check a Payment Receipt. However since the current SET specification does not support Receipts, SET/IOTP sends its own visual information of a Receipt to the SET Bridge.
このAPIは、支払い領収書を確認するために使用されます。ただし、現在のセット仕様は領収書をサポートしていないため、set/ioTPは領収書の独自の視覚情報をセットブリッジに送信します。
Input Parameters ---------------- PayId : M : - WalletId : O : - PassPhrase : O : - PaySchemePackaged : M : See section 8.5.1. Content
Output Parameters ----------------- There is no output Parameter.
This expands an IOTP Payment Receipt Component packaged data into a form which may be used for display or printing purposes.
これにより、IOTP支払い領収書のコンポーネントパッケージデータを、ディスプレイまたは印刷目的に使用できるフォームに拡張されます。
Input Parameters ---------------- PayId : M : - WalletId : O : - PassPhrase : O : - PackagedContent : M : See section 8.5.2.
Output Parameters ----------------- BrandId : M : - ProtocolBrandId : M : - PayInstrumentId : M : - PaySchemePayId : M : LID_M in the SET PRes message is set. (The format of this value must be same as SET Initiation.) Amount : M : Amount * AuthRatio (or CapRatio if available). CapRatio should be the high priority than AuthRatio. CurrCodeType : M : - CurrCode : M : - PayDirection : M : - ProtocolId : M : - ProtocolTransId : O : - TimeStamp : M : This value should be used the Date field of MessageWrapper in the SET PRes message xml:lang : O : This is not used in the SET/IOTP. ConsumerDesc : O : This is not used in the SET/IOTP.
PaymentHandlerDesc : O : This is not used in the SET/IOTP. StyleNetLocn : O : This is not used in the SET/IOTP. PaymentProperty : O : This is not used in the SET/IOTP.
PaymentHandlerDesc:o:これはset/iotpでは使用されていません。stylenetlocn:o:これは、set/iotpでは使用されていません。PayuneProperty:o:これはset/iotpで使用されません。
This API is used to check the payment status. For example, when the OAC receives a Continue Payment Response API, it uses this API if the ContStatus is set to "End". This API can be used at anytime.
このAPIは、支払いステータスを確認するために使用されます。たとえば、OACが継続支払い応答APIを受信すると、contstatusが「終了」に設定されている場合、このAPIを使用します。このAPIはいつでも使用できます。
(1) Consumer Payment Bridge
(1) 消費者支払いブリッジ
Input Parameters ---------------- PayId : M : Set ConsumerPayId WalletId : O : - PassPhrase : O : - Output Parameters ----------------- ProcessState : M : - PercentComplete : O : See 8.13 for the guideline of setting value. CompletionCode : O : See section 8.12. xml:lang : O : - StatusDesc : O : - PayReceiptNameRefs : O : This is not used in the SET/IOTP. PayReceiptPackConts: O : This is not used in the SET/IOTP.
(2) Payment Handler Payment Bridge
(2) 支払いハンドラー支払いブリッジ
Input Parameters ---------------- PayId : M : Set PaymentHandlerPayId WalletId : O : - PassPhrase : O : -
Output Parameters ----------------- ProcessState : M : - PercentComplete : O : See section 8.13 for the guideline of setting value. CompletionCode : O : See section 8.12. xml:lang : O : - StatusDesc : O : - PayReceiptNameRefs : O : This is set "PRes". PayReceiptPackConts: O : This is not used in the SET/IOTP.
This API call returns the SET InqReq Message in order to process a SET Inquiry.
このAPI呼び出しは、セットの問い合わせを処理するために、セットINQREQメッセージを返します。
Input Parameters ---------------- ConsumerPayId : M : - WalletId : O : - Passphrase : O : -
Output Parameters ----------------- PaySchemePackaged : M: Packaged Data to include SET Content InqReq message. See section 8.6.
The Payment Handler uses this API request for Consumer initiated inquiry processing. In SET/IOTP, the Payment Handler's SET Bridge receives a SET InqReq message in an InquirePaymentDetail API. The SET Core processes it, and creates a SET InqRes message. The response encapsulates the SET InqRes message.
支払いハンドラーは、消費者が開始された照会処理に対してこのAPIリクエストを使用します。set/ioTPでは、支払いハンドラーのセットブリッジは、InquirepaymentDetail APIでset inqreqメッセージを受け取ります。セットコアはそれを処理し、セットINQRESメッセージを作成します。応答は、set inqresメッセージをカプセル化します。
Input Parameters ---------------- PaymentHandlerPayId: M : - WalletID : O : - PassPhrase : O : - PaySchemePackaged : M : See section 8.6. Content
Output Parameters ----------------- PaymentHandlerPayId: M : - ProcessState : M : - CompletionCode : O : - xml:lang : O : - StatusDesc : O : - PaySchamePackaged : M : See section 8.6. Content
This chapter describes the core concepts for the development of SET/IOTP.
この章では、Set/IoTPの開発に関するコア概念について説明します。
This document describes SET Initiation Messages based on the [SET EIG]. Merchant sends the 1st SET Initiation Message to the Consumer in order to activate a SET payment transaction. After this message, the other SET Initiation Messages (JPO, etc.) and the SET payment Transaction (SET PinitReq message, etc.) are exchanged between the Consumer and the Payment Handler.
このドキュメントでは、[set eig]に基づいたセット開始メッセージについて説明します。マーチャントは、セットの支払いトランザクションをアクティブにするために、1番目のセット開始メッセージを消費者に送信します。このメッセージの後、他のセット開始メッセージ(JPOなど)とセット支払いトランザクション(Set PinitReqメッセージなど)が消費者と支払いハンドラーの間で交換されます。
+------------+ +----------+ | | | | | |<----------------| Merchant | | | 1st SET InitMsg | | | | +----------+ | Consumer | +----------+ | | | | | |<--------------->| P.H. | | | Other SET Init/ | | +------------+ SET Message +----------+
Figure 11 Relationship between IOTP Messages and SET Messages
図11 IOTPメッセージとセットメッセージの関係
When the Merchant sends any data (e.g., SET SaleDetail) except a SET Related messages (e.g., SET PinitRes message), it can send it by two different methods:
販売者が、セット関連のメッセージ(サレドテールを設定するなど)を送信する場合(例:ピニトレスメッセージなど)、2つの異なる方法で送信できます。
(a) The Merchant sends the data via the Consumer. (b) The Merchant sends the data out-of-band.
(a) 商人は消費者を介してデータを送信します。(b)販売者は、データを帯域外に送信します。
In case (a), the Merchant sends the data by encapsulating it into TradingRoleData.PackagedContent inside the Offer Response Block sent to Consumer. The data is copied to the Payment Request Block and sent to the Payment Handler. This case assumes that the format of the data is already agreed upon between the Merchant and the Payment Handler.
(a)の場合、販売者は、消費者に送信されるオファー応答ブロック内のcordingroledata.packagedcontentにカプセル化することにより、データを送信します。データは支払い要求ブロックにコピーされ、支払いハンドラーに送信されます。このケースは、データの形式が販売者と支払いハンドラーの間ですでに合意されていることを前提としています。
This document does not specify case (b).
このドキュメントでは、ケース(b)を指定しません。
BrandId should be used registered identification for IANA. Now, the following BrandIds have registered:
Brandidは、IANAの登録識別を使用する必要があります。現在、次のブランディッドが登録しています。
Amex, Dankort, JCB, Maestro, MasterCard, MICOS, VISA, atCredits, EZpay, GeldKarte, Mondex, paybox
Amex、Dankort、JCB、Maestro、MasterCard、Micos、Visa、Atcredits、Ezpay、Geldkarte、Mondex、Paybox
ProtocolBrandID is defined as follows:
Protocolbrandidは次のように定義されます。
<Premise> SET BrandID is defined as brand[:Product]. ([] is indicated as optional.) In SET, The brandID is a brand name, which corresponds to the brand of the payment card. Additionally the Product is a product name, which is defined as the type of product within the specific brand such as Gold Card.
<premise> set brandidはブランド[:製品]として定義されています。([]はオプションとして示されています。)セットでは、Brandidはブランド名であり、支払いカードのブランドに対応しています。さらに、この製品は製品名であり、これはゴールドカードなどの特定のブランド内の製品の種類として定義されています。
Set IOTP ProtocolBrandId as follows:
次のようにIOTP Protocolbrandidを設定します。
brand:Product:PCN
ブランド:製品:PCN
In here,
ここに、
o The brand above is the same as the sub data of SET BrandID, as Brand Name (brand), defined in SET. o Product above is the same as the sub data of SET BrandID, as Product Name (Product), defined in SET. o PCN above is the Promotional Card Name, and is written in the SET Certificates.
o 上記のブランドは、セットで定義されているブランド名(ブランド)として、Set Brandidのサブデータと同じです。o上記の製品は、セットで定義されている製品名(製品)として、Set Brandidのサブデータと同じです。上記のo PCNはプロモーションカード名であり、セット証明書に記載されています。
Example:
例:
Visa:Gold:WalMart
ビザ:ゴールド:ウォルマート
Since SET Brand ID has a colon between brand and Product, the two colons should be able to delimit Brand, Product, and PCN.
セットブランドIDにはブランドと製品の間にコロンがあるため、2つのコロンはブランド、製品、およびPCNを区切ることができるはずです。
Product and PCN can omit if necessary. For the detail of these definitions are follows:
製品とPCNは、必要に応じて省略できます。これらの定義の詳細は次のとおりです。
(1) The case of omitting Product
(1) 製品を省略する場合
Definition: brand::PCN Example: VISA::UC_VISA
(2) The case of omitting PCN
(2) PCNを省略した場合
Definition: brand:Product Example: VISA:Gold
(3) The case of omitting Product, PCN
(3) 製品を省略した場合、PCN
Definition: brand Example: VISA
定義:ブランドの例:Visa
Invalid Examples: VISA:Gold: VISA:: VISA: ProtocolBrandId which there is no brand.
無効な例:Visa:Gold:Visa :: Visa:Protocolbrandidブランドはありません。
Protocolld defines as follows:
Protocolldは次のように定義します。
ProtocolId := SETName + Version SETName := "SET" Version := "v" + version + "." + revision
Where the version is number matching a major SET version, and the revision is the number matching a minor SET revision. Example: "SETv1.0","SETv2.0"
バージョンが主要なセットバージョンと一致する数字であり、改訂はマイナーセットリビジョンと一致する数字です。例:「setv1.0」、「setv2.0」
NOTE: In the current version of SET/IOTP, "SETv1.0" is fixed as ProtocolId.
注:set/ioTPの現在のバージョンでは、「setv1.0」はプロトコリッドとして固定されています。
ProtocolBrandId must be unique and depends on BrandId and ProtocolId. The followings are map among BrandId and ProtocolId, which have registered in IANA, and ProtocolBrandId.
Protocolbrandidは一意であり、BrandidおよびProtocolidに依存する必要があります。以下は、IANAに登録されているBrandidおよびProtocolidの間でマップであり、プロトコルブランドです。
BrandId ProtocolId ProtocolBrandId ----------------------------------------- Amex SETv1.0 Amex Dankort SETv1.0 Dankort JCB SETv1.0 JCB MasterCard SETv1.0 MasterCard Nicos SETv1.0 Amex VISA SETv1.0 VISA
Regarding to the BrandIds except above, the BrandId registrant (e.g., credit card company) MUST register it in order to be able to map one to one between ProtocolBrandId and the pair of BrandId and ProtocolId.
上記を除いてブランディッドについては、Brandid登録者(クレジットカード会社など)は、ProtocolbrandidとBrandidおよびProtocolidのペアの間で1対1をマッピングできるようにするために登録する必要があります。
(1) Parameter of PayProtocolPackagedContent
(1) PayProtocolpackagedContentのパラメーター
Name : O : This is not used in SET/IOTP. Content : M : This should be set "PCDATA". Transform : M : This is set "BASE64". ContentData : M : SET specific protocol data. Includes data that is used to create the 1st SET Initiation Message that is not contained in other IOTP elements.
名前:O:これはset/iotpで使用されません。コンテンツ:M:これは「PCDATA」を設定する必要があります。変換:M:これは「base64」に設定されています。ContentData:M:特定のプロトコルデータを設定します。他のIOTP要素に含まれていない最初のセット開始メッセージの作成に使用されるデータが含まれています。
(2) Parameter in the ContentData
(2) ContentDataのパラメーター
Parameters of ContentData are described below. The Field Values follow the [SET EIG].
ContentDataのパラメーターについては、以下に説明します。フィールド値は[set eig]に従います。
Field Required ------------------------------------ MIME-Version Optional Content-Transfer-Encoding Mandatory SET-Initiation-Type Mandatory SET-LID-M Optional SET-InstallTotalTrance Optional SET-Recurring Optional SET-Ext-OID Optional SET-Ext-Data Optional SET-Ext-Mandatory Optional SET-Echo-In-Response Optional SET-Echo-In-Request Optional
For Example:
例えば:
MIME-Version: 1.0 Content-Transfer-Encoding: Binary SET-Initiation-Type: Payment-Initiation SET-Recurring: 31 19960223 SET-Service-URL: http://www.custcare.com/index.html SET-LID-M: 515A533033363632594B
MIME-version:1.0コンテンツトランスファーエンコード:バイナリセットイネ型タイプ:支払い開始セットリカル:31 19960223 SetService-URL:http://www.custcare.com/index.html set-lid-M:515A533033363632594B
Note: The contents in ProtoclPackagedContent must be US-ASCII and encoded by BASE64.
注:protoclpackagedContentの内容は、us-asciiであり、base64によってエンコードされている必要があります。
(1) Information of PayInstrument
(1) Payinstrumentの情報
Returns a list of Payment Instrument IDs related to the BrandId and ProtocolBrandId. In this document, BrandId and ProtocolId are defined in section 8.2.
BrandidおよびProtocolbrandidに関連する支払い機器IDのリストを返します。このドキュメントでは、Brandidとプロトコリッドはセクション8.2で定義されています。
In this document, Brand has two recognized meanings in SET/IOTP, as follows:
このドキュメントでは、ブランドには次のように、Set/IoTPに2つの認識されている意味があります。
Brand as Primary Brand: The Primary Brand is the Brand which is defined as brand in SET, such as VISA, MasterCard, Nicos.
プライマリブランドとしてのブランド:プライマリブランドは、Visa、MasterCard、Nicosなど、セットのブランドとして定義されているブランドです。
Brand as Dual Brand or Promotional Brand: The Dual Brand is the payment instrument which has two Brand, such as UC-VISA (UC Card and VISA Card) This style is popular in Japan.
デュアルブランドまたはプロモーションブランドとしてのブランド:デュアルブランドは、UC-Visa(UCカードとビザカード)などの2つのブランドを持つ支払い機器です。このスタイルは日本で人気があります。
A Promotional Brand means that, if the Consumer pays with that Brand, then the Consumer will receive some additional benefit such as discount or frequent flyer point.
プロモーションブランドとは、消費者がそのブランドに支払う場合、消費者は割引や頻繁なフライヤーポイントなどの追加の利点を受け取ることを意味します。
1. ProtocolBrandId as a Primary Brand
1. 主要なブランドとしてのプロトコルブランド
Example:
例:
"MasterCard", "MasterCard::UC", "MasterCard:Gold:" and "MasterCard::WalMart" are all MasterCard Brands.
「MasterCard」、「MasterCard :: UC」、「MasterCard:Gold:」、および「MasterCard :: Walmart」はすべてMasterCardブランドです。
2. ProtocolBrandId as a Dual Brand or a Promotional Brand
2. デュアルブランドまたはプロモーションブランドとしてのProtocolbrandid
Example:
例:
"MasterCard::UC" is Dual Brand of "MasterCard" and "UC". "SET:MasterCard::WalMart" is Promotional Brand of MasterCard-WallMart.
「MasterCard :: UC」は、「MasterCard」と「UC」のデュアルブランドです。「セット:MasterCard :: Walmart」は、MasterCard-Wallmartのプロモーションブランドです。
The SET Bridge receives the ProtocolBrandId from the OAC in the FindPaymentInstrument Function, (1) If the accepted ProtocolBrandId is XXX:YYY
セットブリッジは、FindPaymentInstrument関数のOACからプロトコルブランドを受信します。
The SET Related Module searches for ProtocolBrandIds with the string "XXX:YYY:*" (* is wild card), the corresponding PaymentInstrumentIds of all ProtocolBrandIds with the matching Primary Brand (regardless of also being a Dual Brand or Promotional Brand) will be returned to the OAC, for the Consumer to select from.
セット関連のモジュールは、文字列「xxx:yyy:*」を使用してプロトコルブランドドを検索します。OACに、消費者が選択できるように。
(2) If the accepted ProtocolBrandId is XXX:YYY:ZZZ
(2) 受け入れられたプロトコルブランドがxxx:yyy:zzzの場合
The SET Related Module searches for ProtocolBrandIDs with the string "XXX:YYY:ZZZ", only the corresponding PaymentInstrumentIds of the ProtocolBrandIds that match the Dual Brand or Promotional Brand will be returned to OAC, for the Consumer to select from.
セットに関連するモジュールは、文字列「xxx:yyy:zzz」を使用してプロトコルブランドディッドを検索します。デュアルブランドまたはプロモーションブランドに一致するプロトコルブランドの対応する支払いのみがOACに返されます。
Example:
例:
Assume ProtocolBrandIds are correspond to PaymentInstrumentIds in the SET Bridge as follows,
プロトコルブランド化は、次のように、セットブリッジの支払いinStrumentidsに対応していると仮定します。
ProtocolBrandId PaymentInstrumentId ------------------------------------------ MasterCard 1 MasterCard::UC 2 MasterCard::WallMart 3 VISA::UC 4
If the SET Bridge receives a ProtocolBrandId as "MasterCard" in the FindPaymentInstrument Function, the SET Bridge will return "1","2", and "3". However, if the SET Bridge receives a ProtocolBrandId as "MasterCard::UC" to OAC, SET Bridge will returns only "2".
Set BridgeがFindPaymentInstrument関数の「マスターカード」としてプロトコルブランドを受信した場合、セットブリッジは「1」、「2」、および「3」を返します。ただし、セットブリッジがOACに「MasterCard :: UC」としてプロトコルブランドを受信した場合、セットブリッジは「2」のみを返します。
(1) Create TradingRolePackagedContent
(1) tradingrolepackagedcontentを作成します
If necessary, The SET Related Module generates TradingRolePackagedContent corresponded to the received ReceiverOrgID. The ContentData of TradingRolePackagedContent is the information which the Payment Handler needs to process the SET Transaction (for example, the SET SaleDetail. and the SET OD). The ContentData, Content, and the Transform must be agreed upon between the Merchant and the Payment Handler beforehand.
必要に応じて、セット関連のモジュールは、受信した受信者に対応するTradingRolePackagedContentを生成します。TradingRolepackagedContentのContentDataは、設定されたトランザクション(たとえば、セットSaledetail。およびSet OD)を処理するために支払いハンドラーが必要とする情報です。ContentData、コンテンツ、および変革は、事前に商人と支払いハンドラーの間で合意する必要があります。
The Name Attribute of the packaged contents must include "Payment:" as the prefix, for example "Payment:SET-OD". If there is no PackagedContent corresponding to ReceiverOrgID, such that the SET Related Module does not need to create the PackagedContent, the TradingRolePackagedContent is not created.
パッケージ化されたコンテンツの名前属性には、「支払い:」をプレフィックスとして含める必要があります。たとえば、「支払い:set-od」です。受信機に対応するパッケージコンテンツがない場合、セット関連のモジュールがパッケージコンテンントを作成する必要がないようにするため、TradingrolepackagedContentは作成されません。
Parameters in TradingRolePackagedContent ---------------------------------------- Name : O : This is not specified in the current SET/IOTP. Content : M : Should be identical between the Payment Handler and the Merchant. Transform : M : Should be identical between the Payment Handler and the Merchant. ContentData : M : Element Data for the Payment Handler to process the SET Transaction. Should be identical between the Payment Handler and the Merchant.
(1) Process of the 1st SET Initiation Message
(1) 最初のセット開始メッセージのプロセス
Since there are similar items between the SET Initiation Message Fields and IOTP Elements, IOTP elements can be used for the corresponding SET Initiation Fields. Other SET Initiation Fields, except URL information (for detail, see below), is encapsulated in the PayProtocolPackagedContent.
設定された開始メッセージフィールドとIOTP要素の間に同様のアイテムがあるため、IOTP要素を対応するセット開始フィールドに使用できます。URL情報(詳細については、以下を参照)を除く他の開始フィールドは、PayProtocolpackagedContentにカプセル化されています。
This document does not specify how the SET Related Module implements the 1st SET Initiation Process.
このドキュメントでは、セットに関連するモジュールが最初のセット開始プロセスをどのように実装するかを指定していません。
The following table shows the list of SET Initiation Fields that corresponds to IOTP Elements.
次の表は、IOTP要素に対応するセット開始フィールドのリストを示しています。
SET Initiation Field IOTP Element (in TPO.Brandlist) --------------------------------------------------------------- SET-Version Consumer selected ProtocolId SET-Brand Consumer selected ProtocolBrandId SET-Amount Consumer selected Amount Data in CurrencyAmount. -------------------------------------------------------------- SET Initiation Field IOTP Element (in OfferResp) -------------------------------------------------------------- Order Description The hash data of ContentData of PackagedContent of Order Component.
(b) SET-Version:
(b) セットバージョン:
SET-Version can be corresponded to ProtocolId. The version number appears after the "v" for the SET-Version.
セットバージョンは、プロトコリッドに対応できます。バージョン番号は、セットバージョンの「V」の後に表示されます。
ProtocolId -> _______ SETv1.0 ~~~<- SET-Version
Figure 12 ProtocolId vs SET-Version
図12プロトコリッド対セットバージョン
(c) SET-Brand:
(c) セットブランド:
SET-Brand can be corresponded to ProtocolBrandId.
セットブランドは、プロトコルブランドに対応できます。
(d) SET-PurchAmt: It is necessary to adjust the format of the Amount between IOTP and SET, since IOTP and SET use different syntax.
(d) Set-Purchamt:IoTPとSETは異なる構文を使用するため、IOTPとSETの間の量の形式を調整する必要があります。
Assumption:
予測:
o In SET/IOTP, The "ISO4217-A" (the currency code which is represented by three alphabet, such as "USD") is mandatory.
o set/ioTPでは、「ISO4217-A」(「USD」などの3つのアルファベットで表される通貨コード)が必須です。
o Consumer Side SET Related Module should have a mapping table between "ISO4217-A" and "ISO4217-N" (the currency code which is represented by three digit, such as "840").
o 消費者サイドセット関連モジュールには、「ISO4217-A」と「ISO4217-N」(「840」などの3桁で表される通貨コード)の間にマッピングテーブルが必要です。
(d) -1 Content of the SET-PurchAmt
(d) -1 Set-Purchamtのコンテンツ
The content of the SET-PurchAmt is as follows:
Set-Purchamtの内容は次のとおりです。
SET PurchAmt: currency amount amtExp10
Set Purchamt:通貨額amtexp10
For a description see [SET] Book 2, page 299. For example, $129.50 is represented by "840 12950 -2". In this case, the corresponding values for the "currency", "amount" and "amtExp10" are "840", "12950" and "-2" respectively.
説明については、[セット] Book 2、Page 299を参照してください。たとえば、129.50ドルは「840 12950 -2」で表されます。この場合、「通貨」、「金額」、および「AMTEXP10」の対応する値は、それぞれ「840」、「12950」、および「-2」です。
(d) -2 Content of IOTP Amount Elements
(d) -2 IOTP量要素のコンテンツ
The content of the three IOTP amount elements consist of the following: Amount, CurrCodeType and CurrCode. For a description of each, see [RFC 2801]. For example, $129.50 is represented by the following:
3つのIOTP量要素の内容は、次のもので構成されています:量、Currcodetype、Currcode。それぞれの説明については、[RFC 2801]を参照してください。たとえば、129.50ドルは以下で表されます。
CurrCodeType="ISO4217-A" CurrCode="USD" Amount="129.50"
CurrcodeType = "ISO4217-A" Currcode = "USD" nome = "129.50"
(d) -3 Example of how-to-translate
(d) -3ハウツー翻訳の例
The one-to-one mapping between the IOTP format and the SET format is very simple. This example of sequence below uses the example of IOTP amount Element above.
IOTP形式とセット形式の間の1対1のマッピングは非常に簡単です。以下のシーケンスのこの例は、上記のIOTP量要素の例を使用しています。
1) Translate from IOTP CurrCode (ISO4217-A) to SET currency (ISO-4217-N). For example, if CurrCode="USD", then the value of currency is "840".
1) IoTP Currcode(ISO4217-A)から通貨(ISO-4217-N)を設定します。たとえば、Currcode = "USD"の場合、通貨の値は「840」です。
2) Calculate how many decimal places are represented in the Amount. For example, if Amount="129.50", there are "2" decimal places.
2) 量の小数点以下の場所の数を計算します。たとえば、額= "129.50"の場合、「2」小数点があります。
3) [The number of decimal places] *( -1) corresponds to the SET amtExp10. In the above case, SET amtExp10 = 2 * (-1) = -2.
3) [小数点以下の場所の数] *(-1)は、SET AMTEXP10に対応しています。上記の場合、AMTEXP10 = 2 *(-1)= -2を設定します。
4) 10^[The number of the Amount's decimal places] * Amount corresponds to the SET amount. In the above example, SET amount = 10^2 * 129.50 = 12950.
4) 10^[量の小数の場所の数] *金額は、設定された金額に対応します。上記の例では、設定= 10^2 * 129.50 = 12950を設定します。
5) Concatenate three integers and use white spaces as a delimiter.
5) 3つの整数を連結し、デリミッターとして白い空間を使用します。
Finally, in the above case, the SET PurchAmt is represented as "840 12950 -2".
最後に、上記の場合、セット購入は「840 12950 -2」として表されます。
(e) SET OD (Order Description) vs. IOTP Order Information
(e) OD(注文説明)を設定し、IOTP注文情報
In the IOTP, the OAC handles the Order Information, such as display use, as SET uses the Order Information. Payment Handler does not know the actual Order Information because the Merchant and Payment Handler may exist in the separate domains. However, Payment Handler needs to get the SET OD from Merchant via the Consumer or directly because Payment Handler needs the SET OD to create 2nd SET Initiation message and after. In this situation, the Merchant should not pass the actual order information to the Payment Handler because the order information may be considered private data. Therefore, SET/IOTP defines SET OD as the hash of IOTP Order Information. The hash algorithm must be SHA1.
IOTPでは、OACはDisplay使用などの注文情報を処理します。SETは注文情報を使用します。支払いハンドラーは、商人と支払いハンドラーが別々のドメインに存在する可能性があるため、実際の注文情報を知りません。ただし、支払いハンドラーは、消費者を介して商人からセットODを取得する必要があります。この状況では、商人は、注文情報がプライベートデータと見なされる可能性があるため、実際の注文情報を支払いハンドラーに渡すべきではありません。したがって、set/ioTPは、set odをIOTP順序情報のハッシュとして定義します。ハッシュアルゴリズムはSHA1でなければなりません。
But the Order Component may be included two or more Packaged Content (see [RFC 2801]). Therefore SET/IOTP specifies to create hash as follows:
ただし、注文コンポーネントには2つ以上のパッケージコンテンツを含めることができます([RFC 2801]を参照)。したがって、SET/IOTPは、次のようにハッシュを作成するように指定します。
(e) -1. If the Name attribute does not have the Name attribute, such that the Order Component have only one Packaged Content, hash the Contents Data using SHA1 simply and be encoded by BASE64.
(e) -1。名前属性に名前属性がない場合、注文コンポーネントにパッケージ化されたコンテンツが1つしかないように、SHA1を使用してコンテンツデータをハッシュし、base64によってエンコードされます。
(e) -2. Otherwise, such that there exists the Name attribute, sort the Packaged Contents in the UTF-16 character code order of Name attribute and hash the Content Data using SHA1 and concatenate them in proper sequence, then hash it using SHA1 again and be encoded by BASE64.
(e) -2。それ以外の場合は、名前属性が存在するように、UTF-16文字コードの名前属性の順序のパッケージコンテンツを並べ替え、SHA1を使用してコンテンツデータをハッシュして適切なシーケンスで連結し、SHA1を使用して再度ハッシュし、Base64によってエンコードされます。。
NOTE: To avoid different character encodings between applications, in this document, SET OD MUST be constructed from the ContentData in OrderPackagedContent as follows:
注:アプリケーション間の異なる文字エンコーディングを回避するには、このドキュメントでは、次のように順序PackagedContentのContentDataから設定されたODを構築する必要があります。
(1) Convert it to network byte ordered Unicode encoding data. (2) Hash (1) using SHA1 (3) Convert (2) to BASE64 US-ASCII data
(1) それをネットワークバイトに変換し、順序付けられたUnicodeエンコードデータに変換します。(2)HASH(1)SHA1(3)(2)をbase64 US-ASCIIデータに変換する
Therefore, "Content-Type","charset" MUST be "text/plain","us-ascii" respectively when SET Initiation message is constructed.
したがって、「Content-Type」、「Charset」は、設定された開始メッセージが作成された場合、それぞれ「テキスト/プレーン」、「US-ASCII」でなければなりません。
(f) SET-***-URL vs. IOTP Net Location
In IOTP, the OAC handles location data therefore the OAC does not need to pass net location data on to the OPB. However, some vender implemented consumer SET/IOTP wallets may need the URL information to process the SET Initiation. Thus, if necessary, the Consumer's SET Related Module must set appropriate URL data to SET-***-URL.
(2) Create the next SET related message
(2) 次のセット関連メッセージを作成します
Generate SET related message (SET PInitReq or SET Initiation Response) at the SET Related Module, to be sent to the Payment Handler.
セット関連モジュールでセット関連メッセージ(SET PINITREQまたはSET Intiatiation Response)を生成し、支払いハンドラーに送信します。
(3) Error check of the next SET related message.
(3) 次のセット関連メッセージのエラーチェック。
If SET related message which is created in (2) is SET Initiation Response and includes any error in it, SET Related Module creates an ErrorResponse message with ErrorCode to "EncapProtErr" and the Severity to "HardError" and sent it to the OAC.
(2)で作成されたセット関連メッセージが開始応答の設定され、エラーが含まれている場合、セット関連モジュールは、「encapproterr」にエラーコードを備えた誤差メッセージを作成し、「harderror」に重大度を作成してOACに送信します。
(4) Create PaySchemePackagedContent
(4) PayschemepackagedContentを作成します
The followings are the parameter of PaySchemePackagedContent in StartPaymentConsumerResponse.
以下は、StartPaymentConsumerresponseのPayschemepackagedContentのパラメーターです。
ContentData : M : SET Related Message which is encoded by BASE64. (e.g., SET PinitRes message or SET Initiation Response Message) Name : O : This is not used in the current SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64".
ContentData:M:Base64によってエンコードされる関連メッセージを設定します。(たとえば、Pinitresメッセージを設定するか、開始応答メッセージを設定します)名前:O:これは現在のセット/IOTPで使用されません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。
(5) Store of the Payment Information
(5) 支払い情報のストア
SET Bridge should store the following in the DataBase:
セットブリッジは、データベースに次のものを保存する必要があります。
o ConsumerPayId o PaySchemePackagedContent o ContStatus o ContentSoftwareId (corresponding to the PaySchemePackagedContent) o ProcessState
o ConsumerPayid o PayschemepackagedContent o contstatus o contentsoftwareid(payschemepackagedcontentに対応)oプロセスステート
(1) Process for TradingRoleData
(1) Tradingroledataのプロセス
SET Bridge must processes appropriately, for example pass it to the SET Core, if there exists the TradingRolePackagedContent as the input Parameter.
Set Bridgeは、入力パラメーターとしてTradingrolepackagedContentが存在する場合、たとえばそれをSet Coreに渡すなど、適切に処理する必要があります。
(2) SET Specific Process
(2) 特定のプロセスを設定します
The SET Related Module processes the SET Initiation Response or the SET Transaction (SET PInitReq). In addition, the SET Related Module generates a message (the next SET Initiation Message or SET PInitRes) corresponding to the results of the processed message. This message will be sent to the Consumer.
セットに関連するモジュールは、セット開始応答またはセットトランザクション(SET PINITREQ)を処理します。さらに、セット関連モジュールは、処理されたメッセージの結果に対応するメッセージ(次のセット開始メッセージまたはセットピニトレ)を生成します。このメッセージは消費者に送信されます。
(3) Error check of the next SET related message.
(3) 次のセット関連メッセージのエラーチェック。
If SET related message which is created in (2) includes any error, SET Related Module create an ErrorResponse message with ErrorCode to "EncapProtErr" and the Severity to "HardError" and sent it to the OAC.
(2)で作成された関連メッセージが含まれている場合、エラーが含まれている場合、セット関連のモジュールは、「encapproterr」へのエラーコードと「harderror」への重大度を使用して誤差メッセージを作成し、OACに送信します。
(4) Generate PaySchemePackagedContent
(4) PayschemepackagedContentを生成します
PaySchemePackagedContent which Encapsulate the SET Initiation Message or SET PInitRes into ContentData and generate the PaySchemePackagedContent. The Parameters of PaySchemePackagedContent as Output is as follows:
設定された開始メッセージをカプセル化するか、ピニトレをContentDataに設定し、PayschemepackagedContentを生成するPayschemepackagedContent。出力としてのPayschemepackagedContentのパラメーターは次のとおりです。
ContentData : M : SET Related Message which is encoded by BASE64 (e.g., SET PinitRes message or SET Initiation Response Message). Name : O : This is not used in the current SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64"
(1) SET Specific Process
(1) 特定のプロセスを設定します
The Parameters of PaySchemePackagedContent as Input is as follows:
入力としてのPayschemepackagedContentのパラメーターは次のとおりです。
ContentData : M : SET Related Message which is encoded by BASE64 (e.g., SET PinitRes message, SET PRes message or SET Initiation Response Message). Name : O : This is not used in the current SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64"
ContentData:M:Base64によってエンコードされる関連メッセージを設定します(たとえば、Pinitresメッセージの設定、Presメッセージの設定、または開始応答メッセージの設定)。名前:O:これは現在のセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります
SET Related Module processes the SET Related Message in the PaySchemePackagedContent, then SET Related Message corresponding to the processed message is created if necessary.
セット関連モジュールは、payschemepackagedcontentのセット関連メッセージを処理し、必要に応じて処理されたメッセージに対応する関連メッセージが作成されます。
(2) SET Related Message Error Check
(2) 関連するメッセージエラーチェックを設定します
If SET related message which is created in (2) includes any error, SET Related Module create an ErrorResponse message with ErrorCode to "EncapProtErr" and the Severity to "HardError" and sent it to the OAC.
(2)で作成された関連メッセージが含まれている場合、エラーが含まれている場合、セット関連のモジュールは、「encapproterr」へのエラーコードと「harderror」への重大度を使用して誤差メッセージを作成し、OACに送信します。
(3) Create PaySchemePackagedContent
(3) PayschemepackagedContentを作成します
The followings are the parameter of PaySchemePackagedContent in ContinueProcessResponse.
以下は、ContinueEprocessResponseにおけるPayschemepAckagedContentのパラメーターです。
ContentData : M : SET Related Message which is encoded by BASE64 (e.g., SET PinitReq message, SET PReq message or SET Initiation Response Message).
ContentData:M:Base64によってエンコードされる関連メッセージを設定します(たとえば、PinitReqメッセージの設定、Preqメッセージの設定、または開始応答メッセージの設定)。
Name : O : This is not used in the current SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64".
名前:O:これは現在のセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。
If the ContentData which has received from Payment Handler is SET PRes message, this data is not created.
支払いハンドラーから受信したContentDataがPRESメッセージを設定した場合、このデータは作成されません。
(1) Brand Integrity Check between IOTP Elements and SET Elements
(1) IOTP要素と設定要素間のブランド整合性チェック
Since the Consumer sets the Amount and Brand in the SET Message, based on the IOTP message, it might be altered when the IOTP message is copied to the SET message. Thus, the Payment Handler needs to check the Elements in IOTP components (Payment, etc.) and the Elements in the SET message to make sure they are consistent. The IOTP Brand specified by the Merchant should correspond to the Brand used in the SET payment.
IOTPメッセージに基づいて、消費者はセットメッセージに金額とブランドを設定するため、IOTPメッセージがセットメッセージにコピーされると変更される可能性があります。したがって、支払いハンドラーは、IOTPコンポーネントの要素(支払いなど)とセットメッセージの要素を確認して、それらが一貫していることを確認する必要があります。商人が指定したIOTPブランドは、セット支払いで使用されるブランドに対応する必要があります。
The Brand Integrity check sequence is as follows:
ブランドの整合性チェックシーケンスは次のとおりです。
(a) After receiving the SET PReq message, check the Consumer selected Brand information (e.g., ProtocolBrandId) in the IOTP Payment Request against information in the SET certificate in the SET PReq message.
(a) SET Preqメッセージを受信した後、SET Preqメッセージのセット証明書の情報に対するIOTP支払い要求の消費者選択ブランド情報(Protocolbrandidなど)を確認します。
(b) If they do not match, return a SET Bridge Level Error (Severity="HardError", ErrorCode="AttNotValid" and Names="BrandId").
(b) それらが一致しない場合は、セットブリッジレベルエラー(Severity = "harderror"、errorcode = "attnotvalid"、names = "brandid")を返します。
Additionally, the SET PReq message signature must be verified with the SET CardHolder's certificate. (This is done during a normal SET Transaction.)
さらに、SET Preqメッセージ署名は、セットカード所有者の証明書で検証する必要があります。(これは、通常のセットトランザクション中に行われます。)
NOTE: This integrity check is necessary evenif There is no Promotional Card Name in the ProtocolBrandId because SET may have selected the MasterCard even though IOTP has selected the VISA.
注:IOTPがビザを選択していてもMasterCardを選択した可能性があるため、プロトコルブランドにプロモーションカード名がない場合でも、この整合性チェックが必要です。
(2) SET Related Process
(2) 関連するプロセスを設定します
Encapsulate the SET related Message (SET Initiation Message or SET Transaction Message) in to Content Data of PaySchemePackagedContent and send it to the Sender.
SET関連のメッセージ(開始メッセージを設定するか、トランザクションメッセージを設定する)をカプセル化して、PaySchemePackagedContentのコンテンツデータに挿入し、送信者に送信します。
The followings are the parameters of PaySchemePackagedContent as output.
以下は、出力としてのPayschemepagedContentのパラメーターです。
ContentData : M : SET Related Message which is encoded by BASE64 (e.g., SET PinitReq message, SET PReq message or SET Initiation Response Message). Name : O : This is not used in the current SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64".
ContentData:M:Base64によってエンコードされる関連メッセージを設定します(たとえば、PinitReqメッセージの設定、Preqメッセージの設定、または開始応答メッセージの設定)。名前:O:これは現在のセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。
(3) SET Related Message Error Check
(3) 関連するメッセージエラーチェックを設定します
If SET related message which is created in (2) includes any error, SET Related Module create an ErrorResponse message with ErrorCode to "EncapProtErr" and the Severity to "HardError" and sent it to the OAC.
(2)で作成された関連メッセージが含まれている場合、エラーが含まれている場合、セット関連のモジュールは、「encapproterr」へのエラーコードと「harderror」への重大度を使用して誤差メッセージを作成し、OACに送信します。
If SET related message which is created in (2) is SET PRes message, and its message includes except:
(2)で作成された関連メッセージが設定されている場合、そのメッセージが含まれます。
(a) CompletionCode in SET PRes message is "authorizationPerformed" and AuthCode is "Approved" or (b) CompletionCode in SET PRes message is "capurePerformed" and CapCode "Success",
(a) SET PRESメッセージの完了コードは「AuthorizationPurformed」であり、AuthCodeは「承認」または(b)SET Presメッセージの完了コードは「capureporformed」およびキャップコード「成功」です。
SET Related Module create ErrorResponse message with ErrorCode to "BusinessError"and the Severity to "HardError" and sent it to the OAC.
関連するモジュールを設定して、エラーコードを「BusinessError」に、重大度を「Harderror」に作成し、OACに送信します。
(4) Create PaySchemePackagedContent
(4) PayschemepackagedContentを作成します
The followings are the parameter of PaySchemePackagedContent in ContinueProcessResponse.
以下は、ContinueEprocessResponseにおけるPayschemepAckagedContentのパラメーターです。
ContentData : M : SET Related Message which is encoded by BASE64 (e.g., SET PinitRes message, SET PRes message or next SET Initiation Message). Name : O : "PRes" only if ContentData includes SET PRes message, otherwise this is not used in the current SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64".
ContentData:M:Base64によってエンコードされる関連メッセージを設定します(たとえば、Pinitresメッセージを設定し、Presメッセージを設定するか、次のセット開始メッセージ)。名前:o:contentDataに設定されたメッセージが含まれている場合のみ、 "pres"が、それ以外の場合、これは現在のセット/ioTPで使用されません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。
If ContentData includes the SET PRes message, ContStatus MUST be "End".
contentDataにSET Presメッセージが含まれている場合、Contstatusは「終了」している必要があります。
(1) Setting ProcessState
(1) ProcessStateの設定
Values for the ProcessState are described in section 8.9.2.
ProcessStateの値は、セクション8.9.2で説明されています。
(2) Setting CompletionCode
(2) 完了コードの設定
Set to "Unspecified" when a SET Business Failure has occurred, and set StatusDesc to the value corresponding to AuthCode or CapCode.
設定されたビジネス失敗が発生したときに「不特定」に設定され、StatusDESCをAuthCodeまたはCapCodeに対応する値に設定します。
(3) Setting StatusDesc
(3) StatusDescの設定
The values for PayStatusDesc are not specified in the SET/IOTP.
PayStatusDescの値は、SET/IOTPで指定されていません。
(4) Create PayReceiptNameRefs
(4) PayReceiptnamerefsを作成します
Set to "PRes" in the PayReceiptNameRefs
PayReceiptnamerefsの「pres」に設定します
SET Related Module does not check the Payment Receipt Information especially, sends the general response message as long as valid request message.
セット関連モジュールは、支払い領収書情報を特に確認しません。有効なリクエストメッセージがある限り、一般的な応答メッセージを送信します。
The Parameters of PayReceiptPackagedContent are followings:
PayReceiptPackagedContentのパラメーターは次のとおりです。
Name : O : This MUST be set "PRes" Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64". ContentData : M : SET PRes message which is encoded by BASE64.
名前:O:これは「pres」コンテンツを設定する必要があります:m:このフィールドは「pcdata」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。ContentData:M:Base64によってエンコードされるPresメッセージを設定します。
(1) PayReceiptPackagedContents
(1) PayReceiptPackagedContents
The Parameters of PayReceiptPackagedContent are as follows:
PayReceiptPackagedContentのパラメーターは次のとおりです。
Name : O : This MUST be set "PRes" Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64". ContentData : M : SET PRes message which is encoded by BASE64.
名前:O:これは「pres」コンテンツを設定する必要があります:m:このフィールドは「pcdata」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。ContentData:M:Base64によってエンコードされるPresメッセージを設定します。
(2) Get the current status information
(2) 現在のステータス情報を取得します
SET Related Module gets out the following element from Data Base using ConsumerPayId, PaymentHandlerPayId as keys.
セット関連モジュールは、Consumer PayID、PaymentHandlerPayidをキーとして使用して、データベースから次の要素を取得します。
o BrandId o ProtocolBrandId o PayInstrumentId o Amount o CurrCodeType o CurrCode o PayDirection
o Brandid o Protocolbrandid o Payinstrumentid oカレーコードタイプo Currcode O PayDirection
(3) Get the SET Data
(3) 設定されたデータを取得します
SET Related Module gets the following data from SET PRes message which take as the Request Message.
SET関連モジュールは、リクエストメッセージとして取得するSet Presメッセージから次のデータを取得します。
(a) Date Field in the MessageWrapper Date field between SET and IOTP is slightly different. The different things are as follows:
(a) SETとIOTPの間のMessageWrapperの日付フィールドの日付フィールドは、わずかに異なります。さまざまなことは次のとおりです。
o There is no TimeZone in the Date field of SET.
o セットの日付フィールドにタイムゾーンはありません。
o Second and Milli-second can be omitted in the Date field of SET
o セットの日付フィールドで2番目とmilli-秒を省略できます
Therefore, SET Related Module needs to compensate the Date information when TimeStamp field is set.
したがって、SET関連モジュールは、タイムスタンプフィールドが設定されているときに日付情報を補正する必要があります。
(b) AuthRatio in SET PRes message. (CapRatio is high priority than AuthRatio if available.)
(b) Set Presメッセージのauthratio。(カプラチオは、利用可能な場合はauthratioよりも優先度が高いです。)
(c) LID_M in SET PRes message. (The style of this value is the same as it of SET Initiation message.)
(c) lid_m in set pres message。(この値のスタイルは、開始メッセージと同じです。)
In SET/IOTP, SET Inquiry Initiation is not supported (i.e., omitted). SET Inquiry Messages are embedded in the PaySchemeData element in IOTP Inquiry Messages.
set/ioTPでは、セット照会開始はサポートされていません(つまり、省略)。IOTP問い合わせメッセージのPayschemedata要素に設定された照会メッセージが組み込まれています。
The Parameters of PaySchemePackagedContent in StartPaymentInquiryResponse are follows:
StartPaymentinquiryresponseのPayschemepackagedContentのパラメーターは次のとおりです。
Name : O : This is not used in the SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64". ContentData : M : SET InqReq message which is encoded by BASE64.
名前:O:これはセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。ContentData:M:base64によってエンコードされるInqreqメッセージを設定します。
The Parameters of PaySchemePackagedContent in InqurePaymentStatus are follows:
InQurePaymentStatusのPayschemepackagedContentのパラメーターは次のとおりです。
Name : O : This is not used in the SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64". ContentData : M : SET InqReq message which is encoded by BASE64.
名前:O:これはセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。ContentData:M:base64によってエンコードされるInqreqメッセージを設定します。
The Parameters of PaySchemePackagedContent in InquirePaymentStatusResponse are follows:
InquirePaymentStatusResponseのPayschemepackagedContentのパラメーターは次のとおりです。
Name : O : This is not used in the SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64". ContentData : M : SET InqRes message which is encoded by BASE64.
名前:O:これはセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。ContentData:M:Base64によってエンコードされたInQresメッセージを設定します。
The Parameter of PaySchemePackagedContent in ContinueProcess are follows:
ContinueProcessにおけるPayschemepackagedContentのパラメーターは次のとおりです。
Name : O : This is not used in the SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64". ContentData : M : SET InqRes message which is encoded by BASE64.
名前:O:これはセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。ContentData:M:Base64によってエンコードされたInQresメッセージを設定します。
The Parameter of PaySchemePackagedContent in RequmePaymentConsumerResponse are as follows:
requmepaymentconsumerresponseのpayschemepackagedcontentのパラメーターは次のとおりです。
Name : O : This is not used in the SET/IOTP. Content : M : This field should be set to "PCDATA". Transform : M : This must be set "BASE64". ContentData : M : SET Related Message which is encoded by BASE64 (e.g., SET PinitRes message or SET Initiation Response Message).
名前:O:これはセット/IOTPでは使用されていません。コンテンツ:M:このフィールドは「PCDATA」に設定する必要があります。変換:M:これは「base64」を設定する必要があります。ContentData:M:Base64によってエンコードされる関連メッセージを設定します(たとえば、Pinitresメッセージまたは開始応答メッセージの設定)。
IOTP authentication, which uses the SET Scheme, is not used in SET/IOTP.
SETスキームを使用するIOTP認証は、SET/IOTPで使用されません。
No Status ----> InProgress : When StartPaymentConsumer Function is called
InProgress ---> InProgress : When ContinueProcess Function is called : When ChangeProcessState Function (ProcessState="Failed") is called
inprogress ---> inprogress:continueProcess関数が呼び出されたとき:ChangeProcessState関数(ProcessState = "failed")が呼び出されたとき
InProgress ---> ProcessError : When ChangeProcessState Function (ProcessState="ProcessError") is called : The Technical Error (Hard Error) is occurred in SET Bridge
InProgress ---> ProcessError:ChangeProcessState関数(ProcessState = "ProcessError")が呼び出されたとき:Set Bridgeで技術エラー(ハードエラー)が発生します
InProgress ---> CompletedOK : When ChangeProcessState Function (ProcessState="CompletedOK") is called
inprogress ---> completedok:ChangeProcessState関数(ProcessState = "Completeok")が呼び出されたとき
InProgress ---> Failed : When ChangeProcessState Function (ProcessState="failed") is called : The Business Error is occurred in SET Bridge
inprogress ---> failed:changeprocessState関数(processState = "failed")が呼び出されたとき:set bridgeでビジネスエラーが発生します
InProgress ---> Suspended : When ChangeProcessState Function (ProcessState="Suspended") is called : ErrorCode="ResumeRequired" is is occurred.
InProgress --->懸濁:ChangeProcessState関数(ProcessState = "Suspended")が呼び出された場合:errorCode = "Resumerequired"が発生します。
Suspend ---> InProgress : ResumePaymentConsumer Function is called
中断--->進行中:支払い消費者機能が呼び出されます
Suspend ---> ProcessError : When ChangeProcessState Function (ProcessState="ProcessError") is called (the Technical Error is occurred prior to ResumePayment-Consumer Function call) : The Technical Error (Hard Error) is occurred in SET Bridge (the Technical Error is occurred while ResumePaymentConsumer is calling)
Suspend ---> ProcessError:ChangeProcessState関数(ProcessState = "ProcessError")が呼び出されたとき(再開される前に技術エラーが発生します):Set Bridge(技術エラー(ハードエラー)が発生します(技術エラー)ResumepaymentConsumerが呼び出している間に発生します)
No Status ----> InProgress : When StartPaymentPaymentHandler is called
InProgress ---> InProgress : When ContinueProcess Function is called : When ChangeProcessState Function (ProcessState="Failed") is called
inprogress ---> inprogress:continueProcess関数が呼び出されたとき:ChangeProcessState関数(ProcessState = "failed")が呼び出されたとき
InProgress ---> ProcessError : When ChangeProcessState Function (ProcessState="ProcessError") is called : The Technical Error (Hard Error) is occurred in SET Bridge : SET Error Message is occurred
InProgress ---> ProcessError:ChangeProcessState関数(ProcessState = "ProcessError")が呼び出された場合:技術エラー(ハードエラー)がセットブリッジで発生します:セットエラーメッセージが発生します
InProgress ---> CompletedOK : When SET Transaction is completed.
Inprogress ---> completedok:設定されたトランザクションが完了したとき。
InProgress ---> Failed : When ChangeProcessState Function (ProcessState="failed") is called : The Business Error is occurred in SET Bridge
inprogress ---> failed:changeprocessState関数(processState = "failed")が呼び出されたとき:set bridgeでビジネスエラーが発生します
CompletedOK ---> Failed : When ChangeProcessState Function or CancelPayment Function (ProcessState="Failed") is called and the payment is cancelled.
completedok ---> failed:ChangeProcessState関数またはCancelPayment関数(ProcessState = "Failed")が呼び出され、支払いがキャンセルされます。
SET/IOTP recommends the following regarding Delivery:
SET/IOTPは、配達に関して以下を推奨します。
Physical Goods -------------- For physical goods, the IOTP Delivery Exchanges should be omitted. That is, set DelivExch=False and DelivAndPayResp=False in the Delivery Component. This is to avoid the situation where the IOTP Delivery Handler must check with the IOTP Payment Handler on the status of a credit authorization. When a Delivery Inquiry transaction might occur, the DelivReqNetLocn attribute in the DeliveryData Element must have been specified at the time of the original Offer Response Message. If you want to use the Delivery Exchange, you need to process the inquiry of the credit authorization out of IOTP between IOTP Payment Handler and Delivery Handler.
Digital Goods ------------- For digital goods sold through SET/IOTP, authorization should be processed on a real-time basis.
In SET/IOTP, the CompletionCode, which is a Business Error Code, is set as follows:
set/ioTPでは、ビジネスエラーコードである完了コードが次のように設定されています。
Value Description ------------------------------------------------------ BrandNotSupp This value is not used. CurrNotSupp This value is not used. AuthError The IOTP Authentication has failed for any reason. InsuffFunds This value is not used. InstBrandInvalid This value is not used. PaymentDecl A SET business failure has occurred. InstNotValid This value is not used. BadInstrument This value is not used. Unspecified Unspecified error. There is some known problem or error, which does not fall into one of the other CompletionCodes.
This document recommends to set the PercentComplete as follows:
このドキュメントでは、次のようにパーセントコンフェートを設定することをお勧めします。
SET Related Setting for Setting for Value of Message Consumer Paymnet Handler PercentComplete ------------+---------------+------------------+----------------- SET Initia- |After 1st SET |After 1st SET |20 tion |Initiation |Initiation | |Response has |Response has | |Cteated |Processed | |(See Note) |(See Note) | ------------+---------------+------------------+---------------- SET PinitReq|After Created |After Processed |40 ------------+---------------+------------------+---------------- SET PinitRes|After Processed|After Created |60 ------------+---------------+------------------+---------------- SET PReq |After Created |After Processed |80 ------------+---------------+------------------+---------------- SET PRes |After Processed|After Created |100 ------------+---------------+------------------+---------------- Note: According to the SET Initiation, PercentComplete should be set "20" at the timing of 1st SET Initiation Response is created/processed because number of its message is variable.
In the current version of SET/IOTP, if a technical error occurs in the SET Bridge, the Severity has to be always set to "HardError".
SET/IOTPの現在のバージョンでは、SETブリッジで技術的なエラーが発生した場合、重大度は常に「ハードエラー」に設定する必要があります。
This chapter describes types of handling Errors.
この章では、処理エラーの種類について説明します。
SET/IOTP defines the following error types:
SET/IOTPは、次のエラータイプを定義します。
(1) IOTP Level Error
(1) IOTPレベルエラー
This is defined as an error which is NOT specified in [SET EIG] nor [SET]. IOTP Level Errors are divided into two types according to the following:
これは、[set eig]または[set]で指定されていないエラーとして定義されます。IOTPレベルのエラーは、次の2つのタイプに分割されます。
OAC Level Error: Error in the OAC. This error is defined in the [IOTP].
OACレベルエラー:OACのエラー。このエラーは[IOTP]で定義されています。
SET Related Module Level Error: Error generated in by process on the SET Related Module, not specified in [SET EIG] nor [SET]. For example, when checking the consistency between SET and IOTP elements on SET Related Module, an error might be returned to OAC.
セット関連モジュールレベルエラー:[SET EIG]または[セット]で指定されていないセット関連モジュールのプロセスによって生成されたエラー。たとえば、SET関連モジュール上のSET要素とIOTP要素間の一貫性を確認する場合、エラーがOACに返される場合があります。
(2) SET Level Error
(2) レベルエラーを設定します
This is defined as an error which is specified in [SET EIG] or [SET]. SET Level Errors have been divided into two types of error according to following:
これは、[set eig]または[set]で指定されているエラーとして定義されます。セットレベルエラーは、次のとおり、2種類のエラーに分割されています。
SET Technical Level Error: Error in the SET Related Module. This error is defined in [SET] or [SET EIG]. SET Technical Level Errors are further subdivided into two types of errors:
設定技術レベルエラー:セット関連モジュールのエラー。このエラーは、[set]または[set eig]で定義されます。設定された技術レベルエラーは、さらに2つのタイプのエラーに細分されます。
(a) SET Initiation Error Error while the SET Initiation Process is in progress.
(a) セット開始エラーエラーセット開始プロセスが進行中です。
(b) SET Transaction Error Error when the SET Transaction (SET PInitReq message, SET PReq message, etc.) is in progress.
(b) SETトランザクションエラーエラー設定トランザクション(SET PINITREQメッセージ、SET PREQメッセージなど)が進行中です。
SET Business Level Error: Error when a business error (e.g., an authorization failure) occurs while the SET Transaction is being processed. In SET, Business Level Errors will be returned in the SET PRes message. SET does not use a SET Error Message for this type of error. However, it is necessary to present the OAC with what kind of SET Business Error has occurred.
[ビジネスレベルの設定エラー:エラーSETトランザクションが処理されている間に、ビジネスエラー(承認障害など)が発生した場合。セットでは、SET Presメッセージでビジネスレベルのエラーが返されます。SETは、このタイプのエラーに設定エラーメッセージを使用しません。ただし、OACにどのような種類のビジネスエラーが発生したかを提示する必要があります。
In this below, the details of each errors above are described.
以下では、上記の各エラーの詳細について説明します。
When OAC Level Errors have occurred, if necessary, the sender and receiver must issue ChangeProcessState API and change the status. For the detail of these errors, see [IOTP].
OACレベルのエラーが発生した場合、必要に応じて、送信者と受信機はChangeProcessState APIを発行し、ステータスを変更する必要があります。これらのエラーの詳細については、[IOTP]を参照してください。
This is the error generated in a process on the SET Related Module, not specified in [SET EIG] nor [SET]. For example, when checking the inconsistency between SET and IOTP elements on SET Related Module, it might cause an error. This error should be notified to OAC.
これは、[set eig]または[set]で指定されていないセット関連モジュールのプロセスで生成されるエラーです。たとえば、SET関連モジュール上のSET要素とIOTP要素間の矛盾を確認すると、エラーが発生する可能性があります。このエラーはOACに通知する必要があります。
In this case, as a response message, Payment Scheme Data is not returned. An appropriate information must be set to Status Response.
この場合、応答メッセージとして、支払いスキームデータは返されません。適切な情報をステータス応答に設定する必要があります。
There are two SET Initiation errors as follows:
次のように2つの設定された開始エラーがあります。
o Error generated in SET Initiation Message
o セット開始メッセージで生成されたエラー
o Error generated in SET Initiation Response Message.
o 設定された開始応答メッセージで生成されたエラー。
(1) SET Initiation Message Error
(1) 開始メッセージエラーを設定します
[SET EIG] describes the error handling when a problem rises in SET Initiation Message. So the Consumer will do the same error handling in 9.4.2.
[SET EIG]は、設定された開始メッセージで問題が上昇したときのエラー処理について説明します。そのため、消費者は9.4.2で同じエラー処理を行います。
When SET Initiation Error rises in 1st Initiation Message, an error message will be returned to the Merchant. If an error occurs after 2nd Initiation Message, an error message will be returned to the Payment Handler. SET Initiation Response will be generated having SET-Error-Field in Response Message Header and will be returned ErrorCode as "PayEncapError" and Severity as "HardError".
1回目の開始メッセージで設定された開始エラーが上昇すると、エラーメッセージが販売者に返されます。2回目の開始メッセージの後にエラーが発生した場合、エラーメッセージが支払いハンドラーに返されます。セット開始応答は、応答メッセージヘッダーにセットエラーフィールドを使用して生成され、「Payencaperror」としてエラーコードが「ハードエラー」として重大さが返されます。
(a) SET Initiation Response Error
(a) 開始応答エラーを設定します
In SET EIG, there is no description about the handling on the problems in SET Initiation Response. However, it is necessary to define some handling for the problems in SET/IOTP
SET EIGでは、SET開始応答の問題に関する取り扱いについて説明はありません。ただし、set/iotpの問題の処理を定義する必要があります
(b) Process of Payment Handler
(b) 支払いハンドラーのプロセス
When a problem rises in SET Initiation Response, SET Related Module generates ErrorResponse, which is included the "EnCapProtoErr" as ErrorCode and the "HardError" as Severity. But PaySchemePackagedContent is not included in this API.
設定された開始応答で問題が発生すると、セット関連モジュールは誤差を生成します。これには、「encapprotoerr」がエラーコードとして、「ハードロー」が重大度として含まれます。ただし、PayschemepackagedContentはこのAPIに含まれていません。
(2) Process of Consumer
(2) 消費者のプロセス
ChangeProcessState API must be issued, and ProcessState must be modified.
ChangeProcessState APIを発行する必要があり、ProcessStateを変更する必要があります。
(1) Process of Sender
(1) 送信者のプロセス
When a SET Transaction Error rises, SET Core creates SET Error Message. Then the SET Related Module creates ErrorResponse Message which includes "HardError" as Severity, "EnCapProtoErr" as ErrorCode and PaySchemePackagedContent. The SET Bridge passes the ErrorResponse Message to OAC. OAC will generate an Error Block which includes PaySchemePackagedContent and sends it to the Receiver side.
設定されたトランザクションエラーが上昇すると、セットコアがセットエラーメッセージを作成します。次に、セットに関連するモジュールは、「Harderror」を重大度として、「Ancapprotoerr」をErrorCode、およびPaySchemePackagedContentを含むErrorResponseメッセージを作成します。セットブリッジは、errorResponseメッセージをOACに渡します。OACは、PayschemepackagedContentを含むエラーブロックを生成し、レシーバー側に送信します。
(2) Process of Receiver
(2) 受信機のプロセス
With ContinueProcess API, receiver's OAC sends the message including the PaySchemeData to SET Bridge. SET Bridge passes the SET Error Message to SET Core for this process. After that, SET Bridge sends "End" status with ContinueProcessResponse API.
ContinueEprocess APIを使用すると、受信者のOACは、Basschemedataを含むメッセージを送信してブリッジを設定します。セットブリッジは、セットエラーメッセージを渡して、このプロセスのコアを設定します。その後、Set Bridgeは継続的なResponse APIで「終了」ステータスを送信します。
(1) Process of Payment Handler
(1) 支払いハンドラーのプロセス
SET Related Module checks the SET Business Error in StatusCode in SET PRes message. When SET Transaction Error occurs, SET Related Module creates ErrorResponse Message which is included SET PRes as PaySchemePackagedContent and ErrorCode as "BusinessError" and returns it to OAC. OAC creates Payment Response Block after gets the SET scheme specific receipt in InquireProcessState/Response, and sends it to the Consumer.
SET関連モジュールは、SET PRESメッセージのステータスコードのセットビジネスエラーをチェックします。設定されたトランザクションエラーが発生すると、セット関連モジュールは、set sest presをpayschemepackagedcontentと "businesserror"としてset sest presとして作成し、それをOACに戻します。OACは、InquireProcessState/ResponseでSETスキーム固有の領収書を取得した後、支払い応答ブロックを作成し、消費者に送信します。
(2) Process of Consumer
(2) 消費者のプロセス
SET Related Module conducts the same process as in the process that Consumer receives Payment Response Block.
セット関連モジュールは、消費者が支払い応答ブロックを受け取るプロセスと同じプロセスを実行します。
In the IOTP, Merchant and Payment Handler may exist in different domains. So, if the Merchant passes the payment related information to the Payment Handler via the Consumer, the payment security level may depend on the IOTP. If you want to avoid this, you will need to check integrity of these data by using out-of-band communication between the Merchant and the Payment Handler. In this case, the security level depends on the communication path between them.
IOTPでは、商人と支払いハンドラーが異なるドメインに存在する場合があります。したがって、商人が消費者を介して支払い関連情報を支払いハンドラーに渡す場合、支払いセキュリティレベルはIOTPに依存する場合があります。これを避けたい場合は、商人と支払いハンドラーの間の帯域外通信を使用して、これらのデータの整合性を確認する必要があります。この場合、セキュリティレベルはそれらの間の通信パスに依存します。
The following books provide essential background material. Readers are strongly encouraged to consult these references for more information.
次の本は、必須の背景素材を提供します。読者は、詳細については、これらの参照を参照することを強くお勧めします。
[BASE64] Base64 Content-Transfer-Encoding. A method of transporting binary data defined by MIME. See: RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies. N. Freed & N.Borenstein. November 1996.
[Base64] Base64コンテンツ転移エンコード。MIMEによって定義されたバイナリデータを輸送する方法。参照:RFC 2045:多目的インターネットメール拡張機能(MIME)パート1:インターネットメッセージボディの形式。N.フリード&N。ボーレンシュタイン。1996年11月。
[RFC 2801] Burdett, D., "Internet Open Trading Protocol - IOTP, Version 1.0", RFC 2081, April 2000.
[RFC 2801] Burdett、D。、「インターネットオープントレーディングプロトコル-IOTP、バージョン1.0」、RFC 2081、2000年4月。
[SET] SET Secure Electronic Transaction (TM) , Version 1.0, May 31, 1997 Book 1: Business Description Book 2: Programmer's Guide Book 3: Formal Protocol Definition
[セット]セットセキュアエレクトロニックトランザクション(TM)、バージョン1.0、1997年5月31日ブック1:ビジネス説明書2:プログラマーズガイドブック3:正式なプロトコル定義
[SET EIG] External Interface Guide to SET Secure Electronic Transaction, Sep 24, 1997.
[EIGのセット]セットセキュア電子トランザクションを設定する外部インターフェイスガイド、1997年9月24日。
[SJR] "SET Secure Electronic Transaction Specification" Support for Japanese Requirements, Mar 16, 1998.
[SJR]「セットセット電子トランザクション仕様」日本の要件のサポート、1998年3月16日。
[IOTP Payment API] Hans, W., et al., "Payment API for v1.0 Internet Open Trading Protocol (IOTP)", Work in Progress.
[IOTP Payment API] Hans、W.、et al。、「V1.0インターネットオープントレーディングプロトコル(IOTP)の支払いAPI」、進行中の作業。
[ISO4217] ISO 4217: Codes for the Representation of Currencies. Available from ANSI or ISO.
[ISO4217] ISO 4217:通貨の表現のためのコード。ANSIまたはISOから入手できます。
[XML] Extensible Mark Up Language. A W3C recommendation. See http://www.w3.org/TR/1998/REC-xml-19980210 for the 10 February 1998 version.
[XML]拡張可能なマークアップ言語。W3Cの推奨。1998年2月10日バージョンについては、http://www.w3.org/tr/1998/rec-xml-19980210を参照してください。
This document does not ask for any action from IANA. It references an existing registry, iotp-codes, where at the time of publication of this RFC the following BrandID's are registered:
このドキュメントでは、IANAからのアクションを要求しません。既存のレジストリであるIOTPコードを参照します。このRFCの公開時に、次のBrandidが登録されています。
Amex, Dankort, JCB, Maestro, MasterCard, MICOS, VISA, atCredits, EZpay, GeldKarte, Mondex, paybox
Amex、Dankort、JCB、Maestro、MasterCard、Micos、Visa、Atcredits、Ezpay、Geldkarte、Mondex、Paybox
The author of this document appreciates the following contributors to this protocol (in alphabetic order of company) without which it could not have been developed.
このドキュメントの著者は、このプロトコル(会社のアルファベット順)への以下の貢献者を、それなしでは開発できなかったことを高く評価しています。
Andrew Drapp Hitachi Europe, Ltd.
Andrew Drapp Hitachi Europe、Ltd。
David Burdett Commerce One (ex. Mondex International)
David Burdett Commerce One(Ex。MondexInternational)
Donald Eastlake 3rd Motorola (ex. IBM)
ドナルド・イーストレイク第3モトローラ(例:IBM)
Hans-Bernhard Beykirch SIZ
Hans-Bernhard Beykirch Siz
John Wankmuller MasterCard International
John Wankmuller Mastercard International
Mark Linehan IBM
マーク・ラインハン・イブ
Richad D. Brown Kedemon (ex. Globe SET)
リチャードD.ブラウンケデモン(例:グローブセット)
Werner Hans SIZ
Werner Hans siz
Yoshiaki Kawatsura Hitachi, Ltd. 890 Kashimada Saiwai-ku Kawasaki-shi Kanagawa, 212-8567 Japan
ヨシアキカワツラヒタチ、リミテッド890カシマダサイワイ - クワサキシカナガワ、212-8567日本
EMail: kawatura@bisd.hitachi.co.jp
Copyright (C) The Internet Society (2003). All Rights Reserved.
Copyright(c)The Internet Society(2003)。無断転載を禁じます。
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English.
このドキュメントと翻訳は他の人にコピーされて提供される場合があります。また、それについてコメントまたは説明する派生作品、またはその実装を支援することは、いかなる種類の制限なしに、準備、コピー、公開、および部分的に配布される場合があります。、上記の著作権通知とこの段落がそのようなすべてのコピーとデリバティブ作品に含まれている場合。ただし、このドキュメント自体は、インターネット協会や他のインターネット組織への著作権通知や参照を削除するなど、いかなる方法でも変更できない場合があります。インターネット標準プロセスに従うか、英語以外の言語に翻訳するために必要な場合に従う必要があります。
The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns.
上記の限られた許可は永続的であり、インターネット社会またはその後継者または譲受人によって取り消されることはありません。
This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
この文書と本書に含まれる情報は、「現状」に基づいて提供されており、インターネット社会とインターネットエンジニアリングタスクフォースは、ここにある情報の使用が行われないという保証を含むがこれらに限定されないすべての保証を否認します。特定の目的に対する商品性または適合性の権利または黙示的な保証を侵害します。
Acknowledgement
謝辞
Funding for the RFC Editor function is currently provided by the Internet Society.
RFCエディター機能の資金は現在、インターネット協会によって提供されています。