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)
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.
著作権（C）インターネット協会（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）SETを使用するための支払いの橋の手順を説明します。
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).
この文書では、SETは、（安全な電子取引をSET）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].
この文書は、SETバージョン1.0 [SET]に基づいて書かれています。
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）SET仕様は、特定のブック2に：プログラマーズガイドとBOOK3：フォーマルプロトコル定義は、3）外部インターフェースガイド）は、セキュアな電子取引4を設定するには、インターネットオープン取引補足：アーキテクチャおよび決済API [IOTP API]
SET Messages and Elements are described with the prefix "SET".
SETメッセージと要素は、接頭辞「SET」で説明されています。
Examples: SET PRes SET OD SET SaleDetail
例：SET販売小売のセット圧SET
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この文書で説明する仕様。 SET関連メッセージSETメッセージの両方及びSET開始メッセージ
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.
SET仕様に基づくように、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.
/ IOTPを設定するために特定されている変更を適用しないように、O。 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.
IOTPとSET間の整合性を保つために、O。彼らは同じ意味を持っているとき心変わりはIOTPとSET素子の間に提起してはいけません。
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.
次の表は、SETと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
SETとIOTPの間に、図1のエンティティモデル
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.
支払ハンドラSET決済取引を含む支払いの交渉を処理し、組織。
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
SETは、支払いのために使用されているブランドの独立したベースライン購入O
o Brand Dependent Baseline Purchase when SET is used for payment
SETは、支払いのために使用されているOブランド依存ベースライン購入
o Cash Advances (Brand Independent and Brand Dependent case)
O現金の進歩（ブランド、独立したブランド依存ケース）
o Status Inquiry on SET payments
SET支払いの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
消費者関連SET証明書の登録とOカスタマケアサービス
o Customer Care Service with Consumer Related SET Certificate Registration Inquiry
消費者関連SET証明書の登録お問い合わせとOカスタマケアサービス
SET/IOTP Architecture is as follows:
次のようにSET / 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 SET / 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橋もOACとSETコア間のインタフェースです。
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）：支払いを処理し、既存のソフトウェア。 SET Coreは、BOOK1からBOOK3へSET仕様のメカニズムをサポートするソフトウェアです。 EPSは必ずしもSET EIGで指定されたSET開始プロセッサを実装する必要はありません。 SET関連モジュールの両方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.
消費者は、ウェブ上のインスタンスのために、インターネット上で商品/サービスを選択して、支払い方法を選択します（SETが選択されている）、SETブランド、支払い通貨、その後、請求書を確認しました。
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.
消費者は、注文を確認した後、SET取引でのご注文のために支払います。 SETトランザクションメッセージが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で価値交換取引を介して行うことができます。 SETおよびいくつかの他の支払機構による二支払による最初のお支払いは、ベースラインIOTPでサポートされています。ブランド、独立したブランド依存ケース - キャッシュアドバンスは、2つのタイプがあります。
A Consumer can send a SET Payment Inquiry in IOTP. The SET Message is encapsulated in an IOTP Message.
消費者は、IOTPのSET支払お問い合わせを送信することができます。 SETメッセージはIOTPメッセージにカプセル化されます。
This chapter illustrates the general SET/IOTP message flows.
この章では、一般的なSETを示し/ IOTPメッセージが流れます。
Baseline purchases consist of two types, Brand Independent Purchase and Brand Dependent Purchase. Each type is illustrated in the charts below.
ベースラインの購入には二つのタイプ、ブランドの独立した購入およびブランド依存購入で構成されています。各タイプは、以下のグラフに示されています。
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.
この流れは、ブランドの独立と同じです。
(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.
この流れは、ブランドの独立と同じです。
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バリュー交換取引を利用してクレジットカードで行うことができ進めます。現金でSETトランザクションによる最初の支払い、およびいくつかの他の支払機構による第二支払いを進め、ベースライン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：PackagedContentに第一SET開始プロセスのための情報を含むデータをパッケージ化されたXML、。セクション8.3.1への詳細については、を参照してください。ブランド：M：この文書では、入力パラメータと同じであるBrandIdは、ONLYに設定する必要があります。下記の注を参照してください。 CurrencyAmount：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
ProtocolId：M：このフィールドは、 "SETv1.0" に設定する必要があります。 WalletId：O： - パスフレーズ：O： - ProtocolBrand：M： - BrandPackaged：O：これはSET / IOTPの現在のバージョンのコンテンツで使用されていません。 ProtocolAmount：O：これは、SET / IOTPの現在のバージョンPackagedContentでは使用されません。 PayProtocolPackaged：M：このフィールドは、コンテンツPayProtocol Componentからコピーされます。 OrderPackaged：Mを：注文データ、コンテンツマーチャントのOACセットに関するデータをパッケージ化。 BrandSelBrandInfo：O：これは、SET / IOTPの現在のPackagedContentバージョンでは使用されません。 BrandSelProtocol：O：これはSET / IOTPのAmountInfoPackaged現在のバージョンでは使用されません。コンテンツBrandSelCurrency：O：これはSET / IOTPのAmountInfo現在のバージョンでは使用されません。 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.
SET橋は、このAPIメッセージを受信した場合、SET橋は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のAmountInfoPackaged現在のバージョンでは使用されません。コンテンツ
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は、第一SET開始し、後続のSETメッセージを処理するために消費者のSET橋のために使用されています。
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は、支払ハンドラ側の支払いを開始するために使用されます。 SET関連モジュールは、支払いの初期化を行います。 SET関連モジュールは、受信したSETメッセージを処理し、適切なSETメッセージ（例えば、第2 SET開始又はSET PinitResメッセージ）を返します。
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コンテンツComponentからコピーされます。接頭辞として、例えば、「お支払い方法：SET-OD」：パッケージ化された内容のname属性は、「お支払い」を含める必要があります。 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は、タイムアウト等の取引が何らかの理由で中断されたときに支払い取引を再開するために使用されます。この中断されたトランザクションに関連する最後のSETメッセージが応答として返されます。
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は、SET関連のメッセージを渡すために使用SET橋に、相手から受信し、応答として次のSETメッセージを受け入れています。
(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は、OPBのプロセスの状態を変更するためにOACで使用されています。例えば、SET支払トランザクションが完了した後に支払い状況を変更するために使用されます。エラーや中断が発生した場合は、この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仕様は領収書をサポートしていないので、SET / IOTPは、SET橋に領収書の独自の視覚情報を送信します。
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で使用されていません。 PaymentProperty：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コールは、SETお問い合わせを処理するために、SET 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では、支払ハンドラのSET橋はInquirePaymentDetail APIのSET InqReqメッセージを受け取ります。 SETコアは、それを処理し、SETの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]に基づいて設定開始メッセージについて説明します。マーチャントは、SET決済取引を活性化するために消費者に第一SET開始メッセージを送信します。このメッセージの後、他のSET開始メッセージ（などJPO）とSET決済トランザクション（SETのPinitReqメッセージなど）は、消費者と支払ハンドラの間で交換されています。
+------------+ +----------+
| | | |
| |<----------------| Merchant |
| | 1st SET InitMsg | |
| | +----------+
| Consumer | +----------+
| | | |
| |<--------------->| P.H. |
| | Other SET Init/ | |
+------------+ SET Message +----------+
Figure 11 Relationship between IOTP Messages and SET Messages
IOTPメッセージとSETメッセージとの間の図11の関係
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:
マーチャントは、SET関連メッセージ（例えば、SET PinitResメッセージ）を除いて（例えば、SET SaleDetail）任意のデータを送信するとき、それは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）の場合、商人はオファー応答ブロック内TradingRoleData.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のために登録された識別を使用すべきです。さて、次BrandIdsが登録されています：
Amex, Dankort, JCB, Maestro, MasterCard, MICOS, VISA, atCredits, EZpay, GeldKarte, Mondex, paybox
アメックス、Dankort、JCB、マエストロ、マスターカード、MICOS、VISA、atCredits、EZpay、ゲルトカルテ、モンデックス、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.
[：製品] <前提>は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.
ブランドは、上記のブランド名（商標）として、SET BrandIDの副データと同じであるO、SETで定義されました。 O製品は、上記SETで定義された製品名（製品）として、SET BrandIDのサブデータと同じです。 O PCNは、上記のプロモーションカード名で、SET証明書に書かれています。
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.
SETブランドIDは、ブランドと製品の間にコロンを持っているので、二つのコロンは、ブランド、製品、および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
定義：商標:: PCN例：VISA :: UC_VISA
(2) The case of omitting PCN
PCNを省略（2）ケース
Definition: brand:Product Example: VISA:Gold
定義：ブランド：製品例：VISA：ゴールド
(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：ゴールド：VISA :: VISA：ProtocolBrandId何のブランドがありません。
Protocolld defines as follows:
次のようにProtocolldが定義されています。
ProtocolId := SETName + Version SETName := "SET" Version := "v" + version + "." + revision
ProtocolId：= SETNAME +バージョンのsetName：=バージョン "SET"： "" = "V" +バージョン+を+改訂
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"
どこバージョンには、メジャーSETのバージョンに一致する数で、改定はマイナーSETリビジョンに一致する数です。例： "SETv1.0"、 "SETv2.0"
NOTE: In the current version of SET/IOTP, "SETv1.0" is fixed as ProtocolId.
注：SET / IOTP、「SETv1.0」の現在のバージョンではProtocolIdとして固定されています。
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に依存しなければなりません。以下はBrandIdとProtocolId、IANAに登録されている、とProtocolBrandIdの間でマッピングされています。
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つをマッピングすることができるようにするために、それを登録する必要があり、上記以外BrandIdsにに関する。
(1) Parameter of PayProtocolPackagedContent
PayProtocolPackagedContentの（1）パラメータ
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要素に含まれていない第一SET開始メッセージを作成するために使用されるデータが含まれています。
(2) Parameter in the ContentData
ContentData（2）パラメータ
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-バージョン：1.0コンテンツ転送エンコード：バイナリSET-開始-タイプ：支払い-開始SET-経常：31 19960223 SET-サービス-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
PayInstrumentの（1）情報
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とProtocolIdはセクション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、マスターカード、ニコスとしてSETにブランドとして定義されているブランドです。
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カードとVISAカード）このスタイルは日本で人気があるように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.プライマリブランドとしてProtocolBrandId
Example:
例：
"MasterCard", "MasterCard::UC", "MasterCard:Gold:" and "MasterCard::WalMart" are all MasterCard Brands.
"マスターカード"、 "マスター:: UC"、 "マスターカード：ゴールド：" と "マスター::ウォルマートは、" すべての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.
「マスター:: UCは、」「マスター」と「UC」のデュアルブランドです。 「SET：マスターカードを::ウォルマートは、」マスター・WallMartのプロモーションブランドです。
The SET Bridge receives the ProtocolBrandId from the OAC in the FindPaymentInstrument Function, (1) If the accepted ProtocolBrandId is XXX:YYY
SET橋は、FindPaymentInstrument機能にOACからProtocolBrandIdを受け（1）受け入れProtocolBrandIdはXXXである場合：YYY
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.
文字列でProtocolBrandIdsためのモジュールを検索関連SET「XXX：YYY：*」（*ワイルドカードです）、一致する主ブランドを持つすべてのProtocolBrandIds（関わらず、また、デュアルブランドプロモーションブランドであることの）の対応PaymentInstrumentIdsが返されますから選択する消費者のために、OACへ。
(2) If the accepted ProtocolBrandId is XXX:YYY:ZZZ
（2）受け入れProtocolBrandIdは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.
文字列「：YYY：XXX ZZZ」とProtocolBrandIDsためのモジュールを検索関連SETは、デュアルブランドプロモーションブランドに一致するProtocolBrandIdsの唯一の対応PaymentInstrumentIdsから選択する消費者のために、OACに返されます。
Example:
例：
Assume ProtocolBrandIds are correspond to PaymentInstrumentIds in the SET Bridge as follows,
、次のようにProtocolBrandIdsがSET BridgeでPaymentInstrumentIdsに対応していると仮定
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ブリッジはFindPaymentInstrument機能で「マスター」としてProtocolBrandIdを受信した場合、SET橋は、「2」「1」を返し、「3」になります。しかし、SET橋は、SET橋意志を返すだけ「2」OACに「マスター:: UC」としてProtocolBrandIdを受信した場合。
(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.
必要であれば、SET関連モジュールはTradingRolePackagedContentが受信ReceiverOrgIDに対応して生成します。 TradingRolePackagedContentのContentDataは支払ハンドラは、（例えば、SET SaleDetail。とSETのOD）SETトランザクションを処理するために必要な情報です。 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」：パッケージ化された内容のname属性は、「お支払い」を含める必要があります。 ReceiverOrgIDに対応するPackagedContentがない場合は、SET関連モジュールはPackagedContentを作成する必要がないように、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）第1 SET開始メッセージの処理を
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.
SET開始メッセージフィールドとIOTP要素との間の同様の項目があるので、IOTP要素は、対応するSET開始フィールドに使用することができます。 URL情報を除く他のSET開始フィールドは、（詳細は、下記を参照）、PayProtocolPackagedContentにカプセル化されます。
This document does not specify how the SET Related Module implements the 1st SET Initiation Process.
SET関連モジュールは、第一SET開始プロセスを実装する方法この文書では、指定されていません。
The following table shows the list of SET Initiation Fields that corresponds to IOTP Elements.
次の表は、IOTP要素に対応してSET開始フィールドのリストが表示されます。
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-バージョン：
SET-Version can be corresponded to ProtocolId. The version number appears after the "v" for the SET-Version.
SET-バージョンはProtocolIdに対応させることができます。バージョン番号は、SET-バージョンのための「V」の後に表示されます。
ProtocolId -> _______
SETv1.0
~~~<- SET-Version
Figure 12 ProtocolId vs SET-Version
SET-バージョン対図12 ProtocolId
(c) SET-Brand:
（C）SET-ブランド：
SET-Brand can be corresponded to ProtocolBrandId.
SET-ブランド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消費者サイドSET関連モジュール「ISO4217-A」と（例えば、「840」の3桁で表される通貨コード）「ISO4217-N」との間のマッピングテーブルを有していなければなりません。
(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.
説明は、例えば、[SET]ブック2、ページ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:
量CurrCodeTypeとCurrCode三つIOTP量元素の含有量は、以下から成ります。それぞれの説明については、[RFC 2801]参照。たとえば、$ 129.50は、以下で表されます。
CurrCodeType="ISO4217-A" CurrCode="USD"
CurrCodeTypeは= "ISO4217-A" CurrCode = "USD"
Amount="129.50"
金額= "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形式とSETフォーマットとの間の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）通貨（ISO4217-N）を設定するIOTP CurrCode（ISO4217-A）から翻訳。例えば、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に相当します。上記の場合、SET 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".
最後に、上記の場合には、SET PurchAmtは「840 12950 -2」として表されます。
(e) SET OD (Order Description) vs. IOTP Order Information
IOTP注文情報対（e）のSETのOD（オーダ説明）
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.
SETは、注文情報を使用していますようIOTPでは、OACは、例えばディスプレイ用として、注文情報を処理します。商人と支払いハンドラが別々のドメインに存在する可能性があるため、お支払いハンドラは、実際の注文情報を知りません。支払ハンドラは第二SET開始メッセージを作成した後には、SET ODを必要とするためしかし、支払いハンドラは、消費者を介して、または直接、加盟店からのSET ODを取得する必要があります。注文情報は、プライベートデータと見なすことができるので、このような状況では、マーチャントは、支払ハンドラに、実際の注文情報を渡すべきではありません。したがって、SET / IOTPはIOTP注文情報のハッシュとしてSET ODを定義します。ハッシュアルゴリズムは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:
しかし、次成分は、二つ以上のパッケージ化されたコンテンツを含めてもよい（[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。 Name属性が一つだけパッケージ化されたコンテンツを持っているように次成分という名前の属性を持っていない場合は、単純に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-。それ以外の場合は、Name属性が存在するように、Name属性の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:
注：次のようにアプリケーション間の異なる文字エンコーディングを回避するためには、この文書では、SETのODはOrderPackagedContentにContentDataから構築されなければなりません。
(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）ハッシュ（1）SHA1（3）を用いて、（2）にBASE64 US-ASCIIデータを変換
Therefore, "Content-Type","charset" MUST be "text/plain","us-ascii" respectively when SET Initiation message is constructed.
SET開始メッセージが構築されたときにそのため、「コンテンツタイプ」、「文字セット」は、それぞれ「text / plainの」、「US-ASCII」でなければなりません。
(f) SET-***-URL vs. IOTP Net Location
（f）は、SET - *** - IOTPネット所在地対URL
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.
IOTPでは、OACは、位置データを扱うため、OACはOPBへのNET位置データを渡す必要はありません。しかし、いくつかのベンダーは、消費者のSET / IOTP財布はSET開始を処理するためにURL情報が必要な場合があります実装しました。 *** - - URLを必要に応じてこのように、消費者の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関連モジュールでSET関連のメッセージ（SETのPInitReqまたはSET開始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）が設定される開始応答して作成し、その中の任意のエラーを含んでいるSET関連メッセージは、SET関連モジュールは、のErrorCodeとはErrorResponseメッセージを作成する場合、「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でエンコードされているSET関連のメッセージ。 （例えば、SET PinitResメッセージ又はSET開始応答メッセージ）名：O：これは、現在のSET / IOTPに使用されていません。内容：M：このフィールドは、「PCDATA」に設定する必要があります。変換：M：これは「BASE64」に設定する必要があります。
(5) Store of the Payment Information
（5）お支払い情報のストア
SET Bridge should store the following in the DataBase:
SET橋は、データベースに次のように格納する必要があります：
o ConsumerPayId o PaySchemePackagedContent o ContStatus o ContentSoftwareId (corresponding to the PaySchemePackagedContent) o ProcessState
O ConsumerPayId O PaySchemePackagedContent O ContStatus O ContentSoftwareId ProcessState O（PaySchemePackagedContentに相当）
(1) Process for TradingRoleData
TradingRoleData（1）プロセス
SET Bridge must processes appropriately, for example pass it to the SET Core, if there exists the TradingRolePackagedContent as the input Parameter.
入力パラメータとしてTradingRolePackagedContentが存在する場合SETブリッジプロセスは適宜、例えば、SETコアにそれを通過しなければなりません。
(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関連モジュールは、SET開始応答またはSETトランザクション（SET PInitReq）を処理します。また、SET関連モジュールは、処理されたメッセージの結果に対応するメッセージ（次SET開始メッセージまたはSET PInitRes）を生成します。このメッセージは、消費者に送信されます。
(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）任意のエラーを含んで作成されたSET関連メッセージは、SET関連モジュールは、のErrorCodeとはErrorResponseメッセージを作成する場合、「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にSET開始メッセージまたはSET PInitResをカプセル化し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"
ContentData：M：BASE64（例えば、SET PinitResメッセージ又はSET開始応答メッセージ）によってコードされるSET関連のメッセージ。名前：O：これは現在のSET / IOTPで使用されていません。内容：M：このフィールドは、「PCDATA」に設定する必要があります。変換：M：これは「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（例えば、SET PinitResメッセージ、SET PRESメッセージ又はSET開始応答メッセージ）によってコードされるSET関連のメッセージ。名前：O：これは現在のSET / 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.
SET関連モジュールは、必要に応じて処理されたメッセージに対応して設定関連のメッセージが作成され、その後、PaySchemePackagedContentに設定関連メッセージを処理します。
(2) SET Related Message Error Check
（2）SET関連メッセージエラーチェック
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）任意のエラーを含んで作成されたSET関連メッセージは、SET関連モジュールは、のErrorCodeとはErrorResponseメッセージを作成する場合、「EncapProtErr」および重症度に「HardError」とOACにそれを送信します。
(3) Create PaySchemePackagedContent
（3）PaySchemePackagedContentを作成します。
The followings are the parameter of PaySchemePackagedContent in ContinueProcessResponse.
以下はContinueProcessResponseで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（例えば、SET PinitReqメッセージ、SET PREQメッセージ又はSET開始応答メッセージ）によってコードされるSET関連のメッセージ。
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：これは現在のSET / 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
IOTP要素とSETの要素間の（1）ブランドの整合性チェック
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メッセージがSETメッセージにコピーされるとき、それは変更されるかもしれません。このように、お支払いハンドラは、彼らが一貫していることを確認するためにIOTPコンポーネント（支払いなど）の中の要素とSETメッセージ内の要素をチェックする必要があります。商人によって指定されたIOTPブランドは、SETの支払いに使用されるブランドに対応している必要があります。
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メッセージ内のSET証明書内の情報に対してIOTP支払い要求に消費者選択ブランド情報（例えば、ProtocolBrandId）を確認。
(b) If they do not match, return a SET Bridge Level Error (Severity="HardError", ErrorCode="AttNotValid" and Names="BrandId").
彼らが一致しない場合（b）は、SET橋レベルのエラー（重大度= "HardError"、ErrorCodeが= "AttNotValid" と名= "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メッセージの署名は、SETカード所有者の証明書で検証されなければなりません。 （これは通常のSETトランザクション中に行われます。）
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.
注：SETはIOTPは、VISAを選択しているにもかかわらず、マスターカードを選択している可能性があるため、ブランドのプロトコルに何のプロモーションカード名を存在しない場合でも、この整合性チェックが必要です。
(2) SET Related Process
（2）SETに関する処理
Encapsulate the SET related Message (SET Initiation Message or SET Transaction Message) in to Content Data of PaySchemePackagedContent and send it to the Sender.
PaySchemePackagedContentのコンテンツデータの中でSET関連のメッセージ（SET開始メッセージまたはSETトランザクションメッセージ）をカプセル化して送信者に送信します。
The followings are the parameters of PaySchemePackagedContent as output.
以下は出力としてPaySchemePackagedContentのパラメータです。
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（例えば、SET PinitReqメッセージ、SET PREQメッセージ又はSET開始応答メッセージ）によってコードされるSET関連のメッセージ。名前：O：これは現在のSET / IOTPで使用されていません。内容：M：このフィールドは、「PCDATA」に設定する必要があります。変換：M：これは「BASE64」に設定する必要があります。
(3) SET Related Message Error Check
（3）SET関連メッセージエラーチェック
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）任意のエラーを含んで作成されたSET関連メッセージは、SET関連モジュールは、のErrorCodeとはErrorResponseメッセージを作成する場合、「EncapProtErr」および重症度に「HardError」とOACにそれを送信します。
If SET related message which is created in (2) is SET PRes message, and its message includes except:
で作成された設定に関連するメッセージ（2）を設定PRESメッセージであり、そのメッセージが含まれている場合を除き：
(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メッセージ内CompletionCode "がauthorizationPerformed" とAUTHCODEは "承認済み" であるか、または（b）のSET PRESメッセージ内CompletionCodeが "capurePerformed" とCapCode "成功" であり、
SET Related Module create ErrorResponse message with ErrorCode to "BusinessError"and the Severity to "HardError" and sent it to the OAC.
SET関連モジュールのErrorCodeに「BusinessError」と深刻度を「HardError」とはErrorResponseメッセージを作成し、OACにそれを送りました。
(4) Create PaySchemePackagedContent
（4）PaySchemePackagedContentを作成します。
The followings are the parameter of PaySchemePackagedContent in ContinueProcessResponse.
以下はContinueProcessResponseで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（例えば、SET PinitResメッセージ、SET PRESメッセージまたは次のSET開始メッセージ）によってコードされるSET関連のメッセージ。名前：O：そう、これは現在のSET / IOTPで使用されていないContentDataがSET PRESメッセージが含まれている場合にのみ、「PRES」、。内容：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）設定CompletionCode
Set to "Unspecified" when a SET Business Failure has occurred, and set StatusDesc to the value corresponding to AuthCode or CapCode.
SETビジネス障害が発生したときに、「指定なし」に設定し、かつAUTHCODEまたはCapCodeに対応する値にStatusDescを設定します。
(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.
支払領収書の情報をチェックしませんSET関連モジュールは、特に、限り有効な要求メッセージを、一般的な応答メッセージを送信します。
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：M：このフィールドは、「PCDATA」に設定する必要がありますこれは、「PRES」のコンテンツを設定しなければなりません。変換：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：M：このフィールドは、「PCDATA」に設定する必要がありますこれは、「PRES」のコンテンツを設定しなければなりません。変換：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.
SET関連モジュールは、キーとしてConsumerPayId、PaymentHandlerPayIdを使用して、データベースから次の要素を取得します。
o BrandId o ProtocolBrandId o PayInstrumentId o Amount o CurrCodeType o CurrCode o PayDirection
BrandId ProtocolBrandId CurrCodeType額CurrCode〇〇PayDirection O PayInstrumentId
(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 Dateフィールドに日付フィールドが若干異なっています。次のように異なるものがあります：
o There is no TimeZone in the Date field of SET.
O SETのDateフィールドにはタイムゾーンはありません。
o Second and Milli-second can be omitted in the Date field of SET
O第二およびミリ秒は、SETの日付フィールドで省略することができます
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。 （CapRatioが利用可能な場合AuthRatioより高い優先度です。）
(c) LID_M in SET PRes message. (The style of this value is the same as it of SET Initiation message.)
SET PRESメッセージ（c）においてLID_M。 （この値のスタイルはSET開始メッセージのそれと同じです。）
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において、SET問い合わせ開始はサポートされていない（即ち、省略します）。 SET問い合わせメッセージは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：これはSET / IOTPで使用されていません。内容：M：このフィールドは、「PCDATA」に設定する必要があります。変換：M：これは「BASE64」に設定する必要があります。 ContentData：M：BASE64によってコードされるSET 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：これはSET / IOTPで使用されていません。内容：M：このフィールドは、「PCDATA」に設定する必要があります。変換：M：これは「BASE64」に設定する必要があります。 ContentData：M：BASE64によってコードされるSET 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：これはSET / 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：これはSET / 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：これはSET / IOTPで使用されていません。内容：M：このフィールドは、「PCDATA」に設定する必要があります。変換：M：これは「BASE64」に設定する必要があります。 ContentData：M：BASE64（例えば、SET PinitResメッセージ又はSET開始応答メッセージ）によってコードされるSET関連のメッセージ。
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 ---> ProcessError : When ChangeProcessState Function
(ProcessState="ProcessError") is
called
: The Technical Error (Hard Error)
is occurred in SET Bridge
InProgress ---> CompletedOK : When ChangeProcessState Function
(ProcessState="CompletedOK") is
called
InProgress ---> Failed : When ChangeProcessState Function
(ProcessState="failed") is called
: The Business Error is occurred
in SET Bridge
InProgress ---> Suspended : When ChangeProcessState Function
(ProcessState="Suspended") is
called
: ErrorCode="ResumeRequired" is
is occurred.
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)
No Status ----> InProgress : When StartPaymentPaymentHandler
is called
InProgress ---> InProgress : When ContinueProcess Function
is called
: When ChangeProcessState Function
(ProcessState="Failed") is called
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 ---> CompletedOK : When SET Transaction is completed.
InProgress ---> Failed : When ChangeProcessState Function
(ProcessState="failed") is called
: The Business Error is occurred
in SET Bridge
CompletedOK ---> Failed : When ChangeProcessState Function
or CancelPayment Function
(ProcessState="Failed") is called
and the payment is cancelled.
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では、ビジネスのエラーコードであるCompletionCodeは、設定されます。
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:
このドキュメントは、次のようにPERCENTCOMPLETEを設定することをお勧めします。
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.
注：SET開始によると、PERCENTCOMPLETEは、第一SET開始応答は、そのメッセージの数が可変であるため、処理/作成されたタイミングで「20」を設定する必要があります。
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 Bridgeで発生した場合、SET / IOTPの現在のバージョンでは、重要度は常に「HardError」に設定する必要があります。
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関連モジュールレベルのエラー：SET関連モジュールのプロセスによって生成されたエラーで、[SET EIG]や[SET]に指定されていません。 SETおよびSET関連モジュールのIOTP要素間の整合性をチェックするときたとえば、エラーがOACに返却される可能性があります。
(2) SET Level Error
（2）SETレベルのエラー
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]で指定されたエラーとして定義されます。 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関連モジュールでエラーが発生しました。このエラーは、[SET]または[SET EIG]で定義されています。 SET技術レベルのエラーは、さらに、エラーの2つのタイプに分けられます
(a) SET Initiation Error Error while the SET Initiation Process is in progress.
SET開始プロセスの進行中に（a）の開始エラーエラーを設定します。
(b) SET Transaction Error Error when the SET Transaction (SET PInitReq message, SET PReq message, etc.) is in progress.
（b）は、SETトランザクションエラーエラーを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トランザクションが処理されている間に、ビジネス・エラー（たとえば、認証エラー）が発生します。 SETでは、ビジネスレベルのエラーは、SET PRESメッセージで返されます。 SETは、このタイプのエラーのためにSETエラーメッセージを使用していません。しかし、発生した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関連モジュールの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個のSET開始エラーがあります。
o Error generated in SET Initiation Message
SET開始メッセージで生成されたOエラー
o Error generated in SET Initiation Response Message.
SET開始応答メッセージで生成されたOエラーが発生しました。
(1) SET Initiation Message Error
（1）SET開始メッセージエラー
[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開始メッセージに上昇した場合[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".
SET開始エラーが第一開始メッセージに上昇すると、エラーメッセージが商人に返されます。エラーが2回目開始メッセージの後に発生した場合、エラーメッセージが支払ハンドラに返されます。 SET開始応答は応答メッセージヘッダに設定誤りのフィールドを持つ生成され、「HardError」として「PayEncapError」と重要度とのErrorCodeを返されます。
(a) SET Initiation Response Error
（a）はSET開始レスポンスエラー
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.
問題は、SET開始レスポンスに上昇すると、SET関連モジュールのErrorCodeと重要度として「HardError」として「EnCapProtoErrを」含まれてはErrorResponseを生成します。しかし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.
SETトランザクションエラーが上昇すると、SETコアは、SETのエラーメッセージを作成します。その後、SET関連モジュールのErrorCodeとPaySchemePackagedContentとして重要度、「EnCapProtoErr」として「HardError」が含まはErrorResponseメッセージを作成します。 SET橋はOACにはErrorResponseメッセージを渡します。 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.
ContinueProcess APIを使用すると、受信側のOACは、ブリッジを設定するPaySchemeDataを含むメッセージを送信します。 SET橋は、このプロセスのためにコアを設定するには、SETのエラーメッセージを渡します。その後、SET橋はContinueProcessResponse 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メッセージでのStatusCodeでSETビジネスエラーをチェックします。 SETトランザクションエラーが発生した場合、SET関連モジュールは、「BusinessError」としてPaySchemePackagedContentとのErrorCodeなどのSET PRESを含み、OACに返しているはErrorResponseメッセージを作成します。 OACは、後の支払応答ブロックを作成InquireProcessState /レスポンスでSETスキーム特定の領収書を取得し、消費者に送信します。
(2) Process of Consumer
（2）消費者のプロセス
SET Related Module conducts the same process as in the process that Consumer receives Payment Response Block.
SET関連モジュールは、消費者が支払い応答ブロックを受け取る工程と同様の処理を行っています。
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（Multipurpose Internet Mail Extensions）の第一部：インターネットメッセージ本体のフォーマット。 N.フリード＆N.Borenstein。 1996年11月。
[RFC 2801] Burdett, D., "Internet Open Trading Protocol - IOTP, Version 1.0", RFC 2081, April 2000.
[RFC 2801]バーデット、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
事業内容帳2：プログラマーズ・ガイドブック3：フォーマルプロトコル定義[SET]セキュア電子取引（TM）、バージョン1.0、1997年5月31日ブック1を設定します
[SET EIG] External Interface Guide to SET Secure Electronic Transaction, Sep 24, 1997.
セキュアな電子取引、1997年9月24日を設定するための外付けインターフェースガイド[EIGをSET]。
[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支払いのAPI]ハンス、W.ら、進行中で働いて "決済API v1.0のインターネットオープン取引プロトコル（IOTP）のために"。
[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からの任意のアクションを要求しません。これは、既存のレジストリ、このRFCの発行時点で、次のBrandID年代が登録されているIOTP-コードを参照しています。
Amex, Dankort, JCB, Maestro, MasterCard, MICOS, VISA, atCredits, EZpay, GeldKarte, Mondex, paybox
アメックス、Dankort、JCB、マエストロ、マスターカード、MICOS、VISA、atCredits、EZpay、ゲルトカルテ、モンデックス、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.
アンドリューDrapp日立ヨーロッパ社
David Burdett Commerce One (ex. Mondex International)
デビッド・バーデットコマースワン（例：モンデックス・インターナショナル）
Donald Eastlake 3rd Motorola (ex. IBM)
ドナルドイーストレーク第3モトローラ（例：IBM）
Hans-Bernhard Beykirch SIZ
ハンス・ベルンハルトBeykirch SIZ
John Wankmuller MasterCard International
ジョン・Wankmullerマスターカード・インターナショナル
Mark Linehan IBM
マークLinehan IBM
Richad D. Brown Kedemon (ex. Globe SET)
リチャード・D.ブラウンKedemon（例：グローブSET）
Werner Hans SIZ
ハンス・ヴェルナーYOU
Yoshiaki Kawatsura Hitachi, Ltd. 890 Kashimada Saiwai-ku Kawasaki-shi Kanagawa, 212-8567 Japan
よしあき かわつら ひたち、 Ｌｔｄ。 ８９０ かしまだ さいわいーく かわさきーし かながわ、 ２１２ー８５６７ じゃぱん
EMail: kawatura@bisd.hitachi.co.jp
メールアドレス：kawatura@bisd.hitachi.co.jp
Copyright (C) The Internet Society (2003). All Rights Reserved.
著作権（C）インターネット協会（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 Editor機能のための基金は現在、インターネット協会によって提供されます。