Red Hat Summit第16章 Braintree
Braintree コンポーネント
リンクのコピーリンクがクリップボードにコピーされました!
Camel 2.17 以降で利用可能
Braintree コンポーネントは、以下の支払い方法をサポートする Braintree Payments サービスへのアクセスを提供します。
Maven ユーザーは、このコンポーネントの以下の依存関係を
pom.xml に追加する必要があります。
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-braintree</artifactId>
<version>x.x.x</version>
<!-- use the same version as your Camel core version -->
</dependency>URI 形式
リンクのコピーリンクがクリップボードにコピーされました!
braintree://endpoint-prefix/endpoint?[options]
エンドポイント接頭辞は以下のいずれかになります。
addOnaddressclientTokencreditCardverificationcustomerdiscountmerchantAccountpaymentmethodpaymentmethodNonceplansettlementBatchSummarysubscriptiontransactionwebhookNotification
BraintreeComponent
リンクのコピーリンクがクリップボードにコピーされました!
Braintree コンポーネントは、以下のオプションで設定できます。これらのオプションは、org.apache.camel.component.braintree.BraintreeConfiguration タイプのコンポーネントの Bean プロパティー 設定 を使用して指定できます。
| オプション | タイプ | 説明 |
|---|---|---|
environment
|
String
|
要求の転送先を指定する値 - サンドボックスまたは実稼働 |
merchantId
|
String
|
使用するゲートウェイアカウントの一意の識別子。これは、実際の業者アカウント ID とは異なります。 |
publicKey
|
String
|
ユーザー固有のパブリック ID |
privateKey
|
String
|
共有すべきでないユーザー固有のセキュアな ID。 |
httpLogLevel
|
java.util.logging.Level
|
HTTP 呼び出し の Camel 2.17.1 ロギングレベル |
httpLogName
|
String
|
http 呼び出しをログに記録するために使用する Camel 2 .17.1 ログカテゴリー。デフォルトは Braintree です。 |
httpReadTimeout
|
Integer
|
HTTP 呼び出しの Camel 2.17.1 の読み取りタイムアウト |
上記のオプションはすべて Braintree Payments によって提供されます。
プロデューサーエンドポイント：
リンクのコピーリンクがクリップボードにコピーされました!
プロデューサーエンドポイントはエンドポイント接頭辞を使用し、続いてエンドポイント名と以下で説明する関連オプションを使用できます。一部のエンドポイントには、短縮エイリアスを使用できます。エンドポイント URI には 接頭辞が含まれている必要があります。
必須ではないエンドポイントオプションは [] で示されます。エンドポイントに必須のオプションがない場合は、[] オプションのセットの 1 つを指定する必要があります。プロデューサーエンドポイントは、Camel Exchange In メッセージに含まれる値を持つ endpoint オプションの名前が含まれる必要がある特別なオプション inBody を使用することもできます。
エンドポイントオプションは、エンドポイント URI またはメッセージヘッダーで動的に指定できます。メッセージヘッダー名は CamelBraintree.<option> 形式である必要があります。inBody オプションはメッセージヘッダーを上書きすることに注意してください。つまり、エンドポイントオプションの inBody=option は CamelBraintree.option ヘッダーを上書きすることに注意してください。
エンドポイントおよびオプションの詳細は、Braintree リファレンス( https://developers.braintreepayments.com/reference/overview)を参照してください。
endpoint prefix addOn
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 addOn で呼び出すことができます。
braintree://addOn/endpoint| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| all | List<com.braintreegateway.Addon> |
エンドポイント接頭辞 アドレス
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 address で呼び出すことができます。
braintree://address/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
create
|
customerId, request
|
com.braintreegateway.Result<com.braintreegateway.Address>
|
|
delete
|
customerId, id
|
com.braintreegateway.Result<com.braintreegateway.Address>
|
|
find
|
customerId, id
|
com.braintreegateway.Address
|
|
update
|
customerId, id, request
|
com.braintreegateway.Result<com.braintreegateway.Address>
|
| 名前 | タイプ |
|---|---|
customerId
|
String
|
request
|
com.braintreegateway.AddressRequest
|
id
|
String
|
エンドポイント接頭辞 clientToken
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 clientToken で呼び出すことができます。
braintree://clientToken/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
generate
|
request
|
String
|
| 名前 | タイプ |
|---|---|
request
|
com.braintreegateway.ClientTokenrequest
|
エンドポイント接頭辞 creditCardVerification
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように creditCardverification 接頭辞で呼び出すことができます。
braintree://creditCardVerification/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
find
|
id
|
com.braintreegateway.CreditCardVerification
|
|
search
|
query
|
com.braintreegateway.ResourceCollection<com.braintreegateway.CreditCardVerification>
|
| 名前 | タイプ |
|---|---|
id
|
String
|
query
|
com.braintreegateway.CreditCardVerificationSearchRequest
|
エンドポイント接頭辞 customer
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 customer で呼び出すことができます。
braintree://customer/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| all | |||
| create | request | com.braintreegateway.Result<com.braintreegateway.Customer> | |
| delete | id |
com.braintreegateway.Result<com.braintreegateway.Customer>
|
|
| find | id |
com.braintreegateway.Customer
|
|
| search | query |
com.braintreegateway.ResourceCollection<com.braintreegateway.Customer>
|
|
| update | Id、request |
com.braintreegateway.Result<com.braintreegateway.Customer>
|
| 名前 | タイプ |
|---|---|
| id | 文字列 |
| request |
com.braintreegateway.CustomerRequest
|
| query |
com.braintreegateway.CustomerSearchRequest
|
エンドポイント接頭辞 discount
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 discount を使用して呼び出すことができます。
braintree://discount/endpoint| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| all | List<com.braintreegateway.Discount> |
エンドポイント接頭辞 merchantAccount
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 merchantAccount で呼び出すことができます。
braintree://merchantAccount/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| create | request | com.braintreegateway.Result<com.braintreegateway.MerchantAccount> | |
| find | id | com.braintreegateway.MerchantAccount | |
| update | Id、request | com.braintreegateway.Result<com.braintreegateway.MerchantAccount> |
| 名前 | タイプ |
|---|---|
| id | 文字列 |
| request |
com.braintreegateway.MerchantAccountRequest
|
エンドポイント接頭辞 paymentMethod
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 paymentMethod で呼び出すことができます。
braintree://paymentMethod/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| create | request | com.braintreegateway.Result<com.braintreegateway.PaymentMethod> | |
| delete | token |
com.braintreegateway.Result<com.braintreegateway.PaymentMethod>
|
|
| find |
token
|
com.braintreegateway.PaymentMethod | |
| update |
token、request
|
com.braintreegateway.Result<com.braintreegateway.PaymentMethod> |
| 名前 | タイプ |
|---|---|
| token | 文字列 |
| request | com.braintreegateway.PaymentMethodRequest |
エンドポイント接頭辞 paymentMethodNonce
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 paymentMethodNonce で呼び出すことができます。
braintree://paymentMethodNonce/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| create | paymentMethodToken | com.braintreegateway.Result<com.braintreegateway.PaymentMethodNonce> | |
| find | paymentMethodNonce | com.braintreegateway.PaymentMethodNonce |
| 名前 | タイプ |
|---|---|
paymentMethodToken
|
文字列 |
paymentMethodNonce
|
String
|
エンドポイント接頭辞 plan
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 プラン で呼び出すことができます。
braintree://plan/endpoint| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| all | List<com.braintreegateway.Plan> |
エンドポイント接頭辞 settlementBatchSummary
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 settlementBatchSummary で呼び出すことができます。
braintree://settlementBatchSummary/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| generate | request |
com.braintreegateway.Result<com.braintreegateway.SettlementBatchSummary>
|
| 名前 | タイプ |
|---|---|
| settlementDate | カレンダー |
| groupByCustomField | 文字列 |
エンドポイント接頭辞 subscription
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように subscription 接頭辞で呼び出すことができます。
braintree://subscription/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| cancel | id |
com.braintreegateway.Result<com.braintreegateway.Subscription>
|
|
| create | request |
com.braintreegateway.Result<com.braintreegateway.Subscription>
|
|
| delete | customerId, id |
com.braintreegateway.Result<com.braintreegateway.Subscription>
|
|
| find | id |
com.braintreegateway.Subscription
|
|
| retryCharge | subscriptionId, amount |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| search | searchRequest |
com.braintreegateway.ResourceCollection<com.braintreegateway.Subscription>
|
|
| update | Id、request |
com.braintreegateway.Result<com.braintreegateway.Subscription>
|
| 名前 | タイプ |
|---|---|
| id | 文字列 |
| request | com.braintreegateway.SubscriptionRequest |
customerId
|
文字列 |
subscriptionId
|
文字列 |
amount
|
BigDecimal |
searchRequest
|
com.braintreegateway.SubscriptionSearchRequest. |
エンドポイント接頭辞 transaction
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 transaction で呼び出すことができます。
braintree://transaction/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| cancelRelease | id |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| cloneTransaction | id, cloneRequest |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| クレジット | request |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| find | id | com.braintreegateway.Transaction | |
| holdInEscrow | id | com.braintreegateway.Result<com.braintreegateway.Transaction> | |
| releaseFromEscrow |
id
|
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| refund | id、amount |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| sale | request |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| search | query |
com.braintreegateway.ResourceCollection<com.braintreegateway.Transaction>
|
|
| submitForPartialSettlement | id、amount |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| submitForSettlement | Id, amount, request |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
|
| voidTransaction | id |
com.braintreegateway.Result<com.braintreegateway.Transaction>
|
| 名前 | タイプ |
|---|---|
| id | 文字列 |
| request | com.braintreegateway.TransactionCloneRequest |
cloneRequest
|
com.braintreegateway.TransactionCloneRequest |
| amount | BigDecimal |
query
|
com.braintreegateway.TransactionSearchRequest |
エンドポイント接頭辞 webhookNotification
リンクのコピーリンクがクリップボードにコピーされました!
以下のエンドポイントは、以下のように接頭辞 webhookNotification で呼び出すことができます。
braintree://webhookNotification/endpoint?[options]| エンドポイント | 短縮形エイリアス | オプション | 結果ボディーのタイプ |
|---|---|---|---|
| parse | 署名、ペイロード | com.braintreegateway.WebhookNotification | |
| verify | challenge | 文字列 |
| 名前 | タイプ |
|---|---|
signature
|
String
|
payload
|
文字列 |
challenge
|
String
|
コンシューマーエンドポイント
リンクのコピーリンクがクリップボードにコピーされました!
プロデューサーエンドポイントはいずれもコンシューマーエンドポイントとして使用できます。コンシューマーエンドポイントは、consumer. 接頭辞を持つ Scheduled Poll Consumer オプション を使用して、エンドポイント呼び出しをスケジュールできます。デフォルトでは、配列またはコレクションを返すコンシューマーエンドポイントは、要素ごとにエクスチェンジを 1 つ生成し、それらのルートはエクスチェンジごとに 1 回実行されます。この動作を変更するには、consumer.splitResults=true プロパティーを使用して、リストまたは配列全体の単一のエクスチェンジを返します。
メッセージヘッダー
リンクのコピーリンクがクリップボードにコピーされました!
すべての URI オプションは、CamelBraintree. 接頭辞を持つプロデューサーエンドポイントのメッセージヘッダーで指定できます。
Message body
リンクのコピーリンクがクリップボードにコピーされました!
すべての結果メッセージ本文は、Braintree Java SDK によって提供されるオブジェクトを使用します。プロデューサーエンドポイントは、inBody エンドポイントパラメーターに受信メッセージボディーのオプション名を指定できます。
Examples
リンクのコピーリンクがクリップボードにコピーされました!
<?xml version="1.0"?>
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cm="http://aries.apache.org/blueprint/xmlns/blueprint-cm/v1.0.0"
xsi:schemaLocation="
http://aries.apache.org/blueprint/xmlns/blueprint-cm/v1.0.0 http://aries.apache.org/schemas/blueprint-cm/blueprint-cm-1.0.0.xsd
http://www.osgi.org/xmlns/blueprint/v1.0.0 https://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd
http://camel.apache.org/schema/blueprint http://camel.apache.org/schema/blueprint/camel-blueprint.xsd">
<cm:property-placeholder id="placeholder" persistent-id="camel.braintree">
</cm:property-placeholder>
<bean id="braintree" class="org.apache.camel.component.braintree.BraintreeComponent">
<property name="configuration">
<bean class="org.apache.camel.component.braintree.BraintreeConfiguration">
<property name="environment" value="${environment}"/>
<property name="merchantId" value="${merchantId}"/>
<property name="publicKey" value="${publicKey}"/>
<property name="privateKey" value="${privateKey}"/>
</bean>
</property>
</bean>
<camelContext trace="true" xmlns="http://camel.apache.org/schema/blueprint" id="braintree-example-context">
<route id="braintree-example-route">
<from uri="direct:generateClientToken"/>
<to uri="braintree://clientToken/generate"/>
<to uri="stream:out"/>
</route>
</camelContext>
</blueprint>
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}