カードの追加
最も一般的な支払い方法は、クレジットカードまたはデビットカードによるものです。これらの支払いはリアルタイムで行われるため、支払い処理前またはその処理中に承認されなければなりません。
概要
アカウントがeSuiteに登録されている場合は、支払いアカウントも追加するのが一般的です。最も一般的な支払い方法は、クレジットカード&デビットカードで、システムにカードを追加するには、 UserManageCreditDebitCard という方法を使用します。カードがアカウントに追加されると、カードは承認のために同期して送信されます。承認が成功した場合、カードは使用準備ができています。
Request
C#
[csharp]
using (eDeveloperClient client = new eDeveloperClient())
{
var request = new UserManageCreditDebitCardRequest()
{
clientId = 433,
apiPassword = "c&4RYp$39",
clientUserId = "061015_430_001",
creditCardNumber = "4111111111111111",
creditCardType = "visa",
expiryDate = "08/22"
};
var response = client.UserManageCreditDebitCard(request);
}
[/csharp]
{
var request = new UserManageCreditDebitCardRequest()
{
clientId = 433,
apiPassword = "c&4RYp$39",
clientUserId = "061015_430_001",
creditCardNumber = "4111111111111111",
creditCardType = "visa",
expiryDate = "08/22"
};
var response = client.UserManageCreditDebitCard(request);
}
[/csharp]
リクエストパラメータ
次の表は、UserManageCreditDebitCardコールで提供される引数を示しています。データ型、説明、および各引数の例が含まれています。
| 名称 | データー タイプ |
説明 | 必須か? | 値の例 |
|---|---|---|---|---|
| ClientId | Integer | eSuiteとのインテグレーションを識別するために提供された固有の識別子 | Yes | 433 |
| ApiPassword | String | 発行された固有のeSuiteパスワード。 | Yes | c&4RYp$39 |
| Guid | String | 認証コールから得られたセッション識別子 | No* | e405d86f33c5496 fa72295e80b80d7eb |
| ClientUserId | String | Unique identifier assigned to the customers account by a 3rd Party authorisation system 第三者認証システムによって顧客アカウントに割り当てられた一意の識別子 |
No* | 023478 |
| CreditCardNumber | String | 16桁のクレジットカード番号。新しいカードの詳細を確認する場合に必要です。 | Yes | 4981283767211273 |
| CreditCardType | Enum | クレジットカードの種類。新しいカードを検証しない場合は、未定義として設定します。そうでない場合は、Typeを渡します | No | Visa |
| ExpiryDate | String | クレジット/デビットカードの有効期限をMM/YYの形式で指定します。 | Yes | 02/19 |
| IssueNumber | String | cv2クレジットカード/デビットカードの番号 | No | 135 |
| Cv2Number | String | ユーザーのクレジットカードの発行コードで、カードタイプに必要ない場合は空白のままにします。 | No | 01 |
| BillingHouseName BillingHouseFlatNumber BillingDistrict BillingTownCity BillingCounty BillingPostcode BillingCountry |
String | ユーザーに関連付けられた請求先住所 | No | 41 Rory Avenue, Manchester, Lancashire, M89 6RF, United Kingdom |
*Any one of these parameters is required, but not all. back to top
Return Values
失敗した場合はエラーが返されます。以下の表に、返されるエラーコードとメッセージの詳細を示します。
| Name | Datatype | Description | Example Value |
|---|---|---|---|
| ErrorMessage | String | APIコールの結果としてプラットフォーム内で発生したエラーメッセージ。エラーが発生していない場合は0になります. | "Invalid Web service credentials" |
| ErrorNumber | Integer | エラーの種類を識別する固有のエラー番号 | 1005 |