各種設定

ecforceのWebhook設定

ecforceからecforce checkに受注や顧客のデータを連携するために、ecforce管理画面でWebhookの設定をする必要があります。
以下の手順で設定をしてください。

Webhookについて

Webhookの詳細については、[オプション]Webhook 管理[オプション]Webhook テンプレート管理をご参照ください。

Caution!!

「デフォルト(〇〇)」という名称のWebhookテンプレートは予め設置されているデフォルトのテンプレートで中身が異なりますので、新規に「check連携用」といった任意の名称でそれぞれ作成してください。

Webhookテンプレートの作成

決済 Webhook テンプレートの作成

【設定 >  Webhook 管理 > 決済 Webhook テンプレート管理】画面にて、決済 Webhook用のテンプレートを作成する

▼項目「テンプレート」に設定する内容

{
"id": "{{ payment.order.id }}",
"number": "{{ payment.order.number }}",
"customer_id": "{{ payment.order.customer.id }}",
"prefecture_id": "{{ payment.order.billing_address.prefecture_id }}",
"name01": "{{ payment.order.billing_address.name01 }}",
"name02": "{{ payment.order.billing_address.name02 }}",
"kana01": "{{ payment.order.billing_address.kana01 }}",
"kana02": "{{ payment.order.billing_address.kana02 }}",
"zip01": "{{ payment.order.billing_address.zip01 }}",
"zip02": "{{ payment.order.billing_address.zip02 }}",
"addr01": "{{ payment.order.billing_address.addr01 }}",
"addr02": "{{ payment.order.billing_address.addr02 }}",
"addr03": "{{ payment.order.billing_address.addr03 }}",
"tel01": "{{ payment.order.billing_address.tel01 }}",
"tel02": "{{ payment.order.billing_address.tel02 }}",
"tel03": "{{ payment.order.billing_address.tel03 }}",
"email": "{{ payment.order.customer.email }}",
"times": "{{ payment.order.times }}",
"state": "{{ payment.order.state }}",
"human_state_name": "{{ payment.order.human_state_name }}",
"payment_state": "{{ payment.state }}",
"payment_state_name": "{{ payment.human_state_name }}",
"base_url": "{{ payment.order.url.base_url }}",
"customer_number": "{{ payment.order.customer.number }}",
"total": "{{ payment.order.total }}",
"payment_method_name": "{{ payment.payment_method.name }}",
"item_id": "{{ payment.order.order_items | map: 'id' | join: '_||_' }}",
"item_product_id": "{{ payment.order.order_items | map: 'product' | map: 'id' | join: '_||_' }}",
"item_product_number": "{{ payment.order.order_items | map: 'product' | map: 'number' | join: '_||_' }}",
"item_product_name": "{{ payment.order.order_items | map: 'product' | map: 'name' | join: '_||_' }}",
"item_variant_id": "{{ payment.order.order_items | map: 'variant_id' | join: '_||_' }}",
"item_variant_sku": "{{ payment.order.order_items | map: 'variant' | map: 'sku' | join: '_||_' }}",
"item_variant_name": "{{ payment.order.order_items | map: 'variant' | map: 'name' | join: '_||_' }}",
"item_quantity": "{{ payment.order.order_items | map: 'quantity' | join: '_||_' }}",
"item_price": "{{ payment.order.order_items | map: 'price' | join: '_||_' }}",
"subs_order_item_id": "{{ payment.order.subs_order.order_items | map: 'id' | join: '_||_' }}",
"subs_order_id": "{{ payment.order.subs_order.id }}",
"subs_order_number": "{{ payment.order.subs_order.number }}",
"completed_at": "{{ payment.order.completed_at | date: '%Y/%m/%d %H:%M:%S' }}",
"scheduled_to_be_shipped_at": "{{ payment.order.subs_order.scheduled_to_be_shipped_at | date: '%Y/%m/%d' }}",
"scheduled_to_be_delivered_at": "{{ payment.order.subs_order.scheduled_to_be_delivered_at | date: '%Y/%m/%d' }}",
"tenant_id": "{{ payment.order.tenant_id }}"
}

顧客 Webhook テンプレートの作成

【設定 >  Webhook 管理 > 顧客 Webhook テンプレート管理】画面にて、顧客 Webhook用のテンプレートを作成する

▼項目「テンプレート」に設定する内容

{
"id":"{{ customer.id }}",
"email":"{{ customer.email }}",
"sex_id":"{{ customer.sex.id }}",
"birth":"{{ customer.birth | date: '%Y/%m/%d'}}",
"line_id":"{{ customer.line_id }}",
"name01":"{{ customer.billing_address.name01 }}",
"name02":"{{ customer.billing_address.name02 }}",
"kana01":"{{ customer.billing_address.kana01 }}",
"kana02":"{{ customer.billing_address.kana02 }}",
"tel01":"{{ customer.billing_address.tel01 }}",
"tel02":"{{ customer.billing_address.tel02 }}",
"tel03":"{{ customer.billing_address.tel03 }}",
"zip01":"{{ customer.billing_address.zip01 }}",
"zip02":"{{ customer.billing_address.zip02 }}",
"prefecture_id":"{{ customer.billing_address.prefecture_id }}",
"addr01":"{{ customer.billing_address.addr01 }}",
"addr02":"{{ customer.billing_address.addr02 }}",
"addr03":"{{ customer.billing_address.addr03 }}",
"optin":"{{ customer.optin }}",
"tenant_id":"{{ customer.tenant_id }}"
}

住所 Webhook テンプレートの作成

【設定 >  Webhook 管理 > 住所 Webhook テンプレート管理】画面にて、住所 Webhook用のテンプレートを作成する

▼項目「テンプレート」に設定する内容

{
 "addressable_id": "{{ address.addressable_id }}",
 "addressable_type": "{{ address.addressable_type }}",
 "address_type": "{{ address.type }}",
 "name01": "{{ address.name01 }}",
 "name02": "{{ address.name02 }}",
 "kana01": "{{ address.kana01 }}",
 "kana02": "{{ address.kana02 }}",
 "tel01": "{{ address.tel01 }}",
 "tel02": "{{ address.tel02 }}",
 "tel03": "{{ address.tel03 }}",
 "zip01": "{{ address.zip01 }}",
 "zip02": "{{ address.zip02 }}",
 "prefecture_id": "{{ address.prefecture_id }}",
 "addr01": "{{ address.addr01 }}",
 "addr02": "{{ address.addr02 }}",
 "addr03": "{{ address.addr03 }}"
}

Webhookの作成

決済 Webhookの作成

【設定 >  Webhook 管理 > 決済 Webhook 管理】画面にて、以下の内容のWebhookを作成する
※イベントの個数分のWebhookを作成してください。

項目 設定内容
URL https://check-ec-force.com/admin/check/webhook
イベント名 payment_registration_failed
payment_credit_exam_failed
payment_credit_exam_hold
payment_credit_exam_processing
payment_credit_exam_completed
payment_cash_on_delivery_authed
payment_authed
payment_auth_failed
payment_update_failed
payment_completed
payment_sales_failed
payment_void
payment_void_failed
payment_shipment_report_waiting
payment_shipment_report_failed
テンプレート 手順1で作成した決済 Webhook テンプレート

顧客 Webhookの作成

【設定 >  Webhook 管理 > 顧客 Webhook 管理】画面にて、以下の内容のWebhookを作成する

項目 設定内容
URL https://check-ec-force.com/admin/check/webhook
イベント名 customer_updated
テンプレート 手順2で作成した顧客 Webhook テンプレート

住所 Webhookの作成

【設定 >  Webhook 管理 > 住所 Webhook 管理】画面にて、以下の内容のWebhookを作成する

項目 設定内容
URL https://check-ec-force.com/admin/check/webhook
イベント名 address_customer_billing_updated
テンプレート 手順3で作成した住所 Webhook テンプレート

定期受注 Webhookの作成

【設定 >  Webhook 管理 > 定期受注 Webhook 管理】画面にて、以下の内容のWebhookを作成する

項目 設定内容
URL https://check-ec-force.com/admin/check/webhook
イベント名 subs_order_active
subs_order_canceled
subs_order_suspend
subs_order_destroyed
テンプレート デフォルトの定期受注 Webhook テンプレート

 

この記事の目次

このセクションの記事

各種設定