pokepay_partner_ruby_sdk 0.1.10 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/docs/index.md CHANGED
@@ -149,6 +149,7 @@ response.body
149
149
  - [CreateTransferTransaction](#create-transfer-transaction): 個人間送金
150
150
  - [CreateExchangeTransaction](#create-exchange-transaction):
151
151
  - [GetTransaction](#get-transaction): 取引情報を取得する
152
+ - [RefundTransaction](#refund-transaction): 返金する
152
153
  - [ListTransfers](#list-transfers):
153
154
  - [CreateTopupTransactionWithCheck](#create-topup-transaction-with-check): チャージQRコードを読み取ることでチャージする
154
155
  - [ListBills](#list-bills): 支払いQRコード一覧を表示する
@@ -162,7 +163,9 @@ response.body
162
163
  - [UpdateAccount](#update-account): ウォレット情報を更新する
163
164
  - [ListAccountBalances](#list-account-balances): エンドユーザーの残高内訳を表示する
164
165
  - [ListAccountExpiredBalances](#list-account-expired-balances): エンドユーザーの失効済みの残高内訳を表示する
166
+ - [GetCustomerAccounts](#get-customer-accounts): エンドユーザーのウォレット一覧を表示する
165
167
  - [CreateCustomerAccount](#create-customer-account): 新規エンドユーザーウォレットを追加する
168
+ - [GetShopAccounts](#get-shop-accounts): 店舗ユーザーのウォレット一覧を表示する
166
169
  - [ListCustomerTransactions](#list-customer-transactions): 取引履歴を取得する
167
170
  - [ListShops](#list-shops): 店舗一覧を取得する
168
171
  - [CreateShop](#create-shop): 新規店舗を追加する(廃止予定)
@@ -179,8 +182,8 @@ response.body
179
182
  取引一覧を返します。
180
183
  ```ruby
181
184
  response = $client.send(Pokepay::Request::ListTransactions.new(
182
- from: "2021-03-07T22:47:08.000000+09:00", # 開始日時
183
- to: "2022-03-08T10:30:46.000000+09:00", # 終了日時
185
+ from: "2017-05-10T09:01:07.000000+09:00", # 開始日時
186
+ to: "2017-02-12T17:02:56.000000+09:00", # 終了日時
184
187
  page: 1, # ページ番号
185
188
  per_page: 50, # 1ページ分の取引数
186
189
  shop_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # 店舗ID
@@ -190,8 +193,9 @@ response = $client.send(Pokepay::Request::ListTransactions.new(
190
193
  transaction_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # 取引ID
191
194
  organization_code: "pocketchange", # 組織コード
192
195
  private_money_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # マネーID
193
- is_modified: true, # キャンセルフラグ
194
- types: ["topup", "payment"] # 取引種別 (複数指定可)、チャージ=topup、支払い=payment
196
+ is_modified: false, # キャンセルフラグ
197
+ types: ["topup", "payment"], # 取引種別 (複数指定可)、チャージ=topup、支払い=payment
198
+ description: "店頭QRコードによる支払い" # 取引説明文
195
199
  ))
196
200
  ```
197
201
 
@@ -364,6 +368,18 @@ response = $client.send(Pokepay::Request::ListTransactions.new(
364
368
  4. exchange-inflow
365
369
  他マネーからの流入
366
370
 
371
+ ---
372
+ `description`
373
+ ```json
374
+ {
375
+ "type": "string",
376
+ "maxLength": 200
377
+ }
378
+ ```
379
+ 取引を指定の取引説明文でフィルターします。
380
+
381
+ 取引説明文が完全一致する取引のみ抽出されます。取引説明文は最大200文字で記録されています。
382
+
367
383
  ---
368
384
  成功したときは[PaginatedTransaction](#paginated-transaction)オブジェクトを返します
369
385
  <a name="create-transaction"></a>
@@ -374,10 +390,10 @@ response = $client.send(Pokepay::Request::CreateTransaction.new(
374
390
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
375
391
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
376
392
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
377
- money_amount: 1421,
378
- point_amount: 2284,
379
- point_expires_at: "2024-09-29T14:09:13.000000+09:00", # ポイント有効期限
380
- description: "dnW1ooZFRDSiyltrhPzNi7jenj4X3xdXKxR7POl5XLEB6rdcoyFq3Dy2RXyPUAe3PgOIxNaz33MDlMm45c417ClVPZadCz21oTLg0Zh082rSUmgTJgltXUvopMAE6nKVgCC79b4Ei190OQ71CLczodkHUHlo8UiDVjyL"
393
+ money_amount: 5545,
394
+ point_amount: 6708,
395
+ point_expires_at: "2024-02-06T11:02:52.000000+09:00", # ポイント有効期限
396
+ description: "CafuN856J50SdiADG37eydGENMPuSUGCPNHip0"
381
397
  ))
382
398
  ```
383
399
 
@@ -403,10 +419,11 @@ response = $client.send(Pokepay::Request::CreateTopupTransaction.new(
403
419
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # customer_id: エンドユーザーのID
404
420
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
405
421
  bear_point_shop_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # ポイント支払時の負担店舗ID
406
- money_amount: 8760, # マネー額
407
- point_amount: 2312, # ポイント額
408
- point_expires_at: "2023-08-31T03:26:11.000000+09:00", # ポイント有効期限
409
- description: "初夏のチャージキャンペーン" # 取引履歴に表示する説明文
422
+ money_amount: 7001, # マネー額
423
+ point_amount: 650, # ポイント額
424
+ point_expires_at: "2018-05-18T16:46:21.000000+09:00", # ポイント有効期限
425
+ description: "初夏のチャージキャンペーン", # 取引履歴に表示する説明文
426
+ request_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" # リクエストID
410
427
  ))
411
428
  ```
412
429
 
@@ -505,6 +522,20 @@ response = $client.send(Pokepay::Request::CreateTopupTransaction.new(
505
522
 
506
523
  任意入力で、取引履歴に表示される説明文です。
507
524
 
525
+ ---
526
+ `request_id`
527
+ ```json
528
+ {
529
+ "type": "string",
530
+ "format": "uuid"
531
+ }
532
+ ```
533
+ 取引作成APIの羃等性を担保するためのリクエスト固有のIDです。
534
+
535
+ 取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。
536
+
537
+ リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
538
+
508
539
  ---
509
540
  成功したときは[Transaction](#transaction)オブジェクトを返します
510
541
  <a name="create-payment-transaction"></a>
@@ -517,8 +548,9 @@ response = $client.send(Pokepay::Request::CreatePaymentTransaction.new(
517
548
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # shop_id: 店舗ID
518
549
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # customer_id: エンドユーザーID
519
550
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
520
- 3693, # amount: 支払い額
521
- description: "たい焼き(小倉)" # 取引履歴に表示する説明文
551
+ 6244, # amount: 支払い額
552
+ description: "たい焼き(小倉)", # 取引履歴に表示する説明文
553
+ request_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" # リクエストID
522
554
  ))
523
555
  ```
524
556
 
@@ -582,6 +614,20 @@ response = $client.send(Pokepay::Request::CreatePaymentTransaction.new(
582
614
 
583
615
  任意入力で、取引履歴に表示される説明文です。
584
616
 
617
+ ---
618
+ `request_id`
619
+ ```json
620
+ {
621
+ "type": "string",
622
+ "format": "uuid"
623
+ }
624
+ ```
625
+ 取引作成APIの羃等性を担保するためのリクエスト固有のIDです。
626
+
627
+ 取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。
628
+
629
+ リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
630
+
585
631
  ---
586
632
  成功したときは[Transaction](#transaction)オブジェクトを返します
587
633
  <a name="create-transfer-transaction"></a>
@@ -594,8 +640,9 @@ response = $client.send(Pokepay::Request::CreateTransferTransaction.new(
594
640
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # sender_id: 送金元ユーザーID
595
641
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # receiver_id: 受取ユーザーID
596
642
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
597
- 6392, # amount: 送金額
598
- description: "たい焼き(小倉)" # 取引履歴に表示する説明文
643
+ 2754, # amount: 送金額
644
+ description: "たい焼き(小倉)", # 取引履歴に表示する説明文
645
+ request_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" # リクエストID
599
646
  ))
600
647
  ```
601
648
 
@@ -659,6 +706,20 @@ response = $client.send(Pokepay::Request::CreateTransferTransaction.new(
659
706
 
660
707
  任意入力で、取引履歴に表示される説明文です。
661
708
 
709
+ ---
710
+ `request_id`
711
+ ```json
712
+ {
713
+ "type": "string",
714
+ "format": "uuid"
715
+ }
716
+ ```
717
+ 取引作成APIの羃等性を担保するためのリクエスト固有のIDです。
718
+
719
+ 取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。
720
+
721
+ リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
722
+
662
723
  ---
663
724
  成功したときは[Transaction](#transaction)オブジェクトを返します
664
725
  <a name="create-exchange-transaction"></a>
@@ -668,10 +729,27 @@ response = $client.send(Pokepay::Request::CreateExchangeTransaction.new(
668
729
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
669
730
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
670
731
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
671
- 9228,
672
- description: "NxSNDBAB21jRDnDfUt4YgIyZaTsiHOmcCShoExxXDzwmu0NmtxroKVUk7sDu4lw8ZxL5ooBCUmbexHlOYPdRDRXfcFEKebPAHiatKRmL7K8IMJIBW1vB1RC8WQ75Zq2CPEph5LyiHrKKZHYeA6K"
732
+ 7140,
733
+ description: "Xe1sIjLSVztCspdpKcDGU85LATApzQ2dQG1XtK0UfX1fzmKZw4jAX5TdVMZA3FsBWHTaR7q8iHovbTWoPNbCUX3WmvU0lnYW7MWulxJqejEoXiemEzy22TP2wtSY9IoDSrJUA2sSTBsOwjVmr0",
734
+ request_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" # リクエストID
673
735
  ))
674
736
  ```
737
+
738
+ ---
739
+ `request_id`
740
+ ```json
741
+ {
742
+ "type": "string",
743
+ "format": "uuid"
744
+ }
745
+ ```
746
+ 取引作成APIの羃等性を担保するためのリクエスト固有のIDです。
747
+
748
+ 取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。
749
+
750
+ リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
751
+
752
+ ---
675
753
  成功したときは[Transaction](#transaction)オブジェクトを返します
676
754
  <a name="get-transaction"></a>
677
755
  #### 取引情報を取得する
@@ -696,25 +774,83 @@ response = $client.send(Pokepay::Request::GetTransaction.new(
696
774
 
697
775
  ---
698
776
  成功したときは[Transaction](#transaction)オブジェクトを返します
777
+ <a name="refund-transaction"></a>
778
+ #### 返金する
779
+ ```ruby
780
+ response = $client.send(Pokepay::Request::RefundTransaction.new(
781
+ "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # transaction_id: 取引ID
782
+ description: "返品対応のため" # 取引履歴に表示する返金事由
783
+ ))
784
+ ```
785
+ 成功したときは[Transaction](#transaction)オブジェクトを返します
699
786
  <a name="list-transfers"></a>
700
787
  ####
701
788
  ```ruby
702
789
  response = $client.send(Pokepay::Request::ListTransfers.new(
703
- from: "2017-10-07T19:44:21.000000+09:00",
704
- to: "2018-06-17T19:03:29.000000+09:00",
705
- page: 4180,
706
- per_page: 4035,
790
+ from: "2020-12-08T12:26:18.000000+09:00",
791
+ to: "2017-11-24T07:36:36.000000+09:00",
792
+ page: 4740,
793
+ per_page: 1712,
707
794
  shop_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
708
- shop_name: "kbfNhFw",
795
+ shop_name: "79fqhITnnz7WaCAiQd9B8sle88sl7rSWKN9oQjHsNX48VkSyiuzE1L2wv36YuE4jwp0IiR44I5KLiOrRKq3qxtTGifN6KrraD5uojwDmQdLNOKHIlDiaOh78QfhNbZ3YfGhlbqaOElvScjtjkG1",
709
796
  customer_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
710
- customer_name: "jSSUkqouGV2ULftf3KLiOm0u6OdTYvY1WMa6BMdHbor9Bi8VjYjeAF8N8XvRYyNjj6LzPNoFY0NPc7gW3tdaerbfAUj6MGuDCQRgbbh69IfOOqdFvcvTYHWhMSc2JtDSCuxpXIBKjX0wbEINtuhWyJmxhctiEpL1KlL20SY28CEIpXvCz2lX0WFgkUTJYHHOr63hjnglJCcSZdRjCOwyap0lsb8d4Dc5yMU1TN0yX6wxY6IPoPyEr8klncfG",
797
+ customer_name: "WEjltqaYkhp7caXjUtBcNe9XyY4wthFo0glXBErIUB1p7aPMzXnAdDrY96Gn0OAQ9xSN0zfKx7ivixiVqjgvBNcsQLQxAtJm",
711
798
  transaction_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
712
799
  private_money_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
713
- is_modified: false,
714
- transaction_types: ["exchange", "transfer", "payment", "topup"],
715
- transfer_types: ["topup", "transfer", "exchange", "payment"]
800
+ is_modified: true,
801
+ transaction_types: ["transfer", "payment", "topup", "exchange"],
802
+ transfer_types: ["exchange", "payment", "campaign", "transfer"], # 取引明細の種類でフィルターします。
803
+ description: "店頭QRコードによる支払い" # 取引詳細説明文
716
804
  ))
717
805
  ```
806
+
807
+ ---
808
+ `transfer_types`
809
+ ```json
810
+ {
811
+ "type": "array",
812
+ "items": {
813
+ "type": "string",
814
+ "enum": {
815
+ "topup": "payment",
816
+ "exchange": "transfer",
817
+ "coupon": "campaign"
818
+ }
819
+ }
820
+ }
821
+ ```
822
+ 取引明細の種類でフィルターします。
823
+
824
+ 以下の種類を指定できます。
825
+
826
+ 1. topup
827
+ 店舗からエンドユーザーへの送金取引(チャージ)、またはそのキャンセル取引
828
+
829
+ 2. payment
830
+ エンドユーザーから店舗への送金取引(支払い)、またはそのキャンセル取引
831
+
832
+ 3. exchange
833
+ 他マネーへの流出/流入
834
+
835
+ 4. campaign
836
+ 取引に対するポイント還元キャンペーンによるポイント付与、またはそのキャンセル取引
837
+
838
+ 5. coupon
839
+ クーポンによる値引き処理、またはそのキャンセル取引
840
+
841
+ ---
842
+ `description`
843
+ ```json
844
+ {
845
+ "type": "string",
846
+ "maxLength": 200
847
+ }
848
+ ```
849
+ 取引詳細を指定の取引詳細説明文でフィルターします。
850
+
851
+ 取引詳細説明文が完全一致する取引のみ抽出されます。取引詳細説明文は最大200文字で記録されています。
852
+
853
+ ---
718
854
  成功したときは[PaginatedTransfers](#paginated-transfers)オブジェクトを返します
719
855
  ### Check
720
856
  店舗ユーザが発行し、エンドユーザーがポケペイアプリから読み取ることでチャージ取引が発生するQRコードです。
@@ -771,19 +907,19 @@ QRコード生成時に送金元店舗のウォレット情報や、送金額な
771
907
  支払いQRコード一覧を表示します。
772
908
  ```ruby
773
909
  response = $client.send(Pokepay::Request::ListBills.new(
774
- page: 1083, # ページ番号
775
- per_page: 8979, # 1ページの表示数
776
- bill_id: "OqOmjPQj", # 支払いQRコードのID
910
+ page: 5974, # ページ番号
911
+ per_page: 4994, # 1ページの表示数
912
+ bill_id: "kNd3", # 支払いQRコードのID
777
913
  private_money_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # マネーID
778
- organization_code: "v-n", # 組織コード
914
+ organization_code: "jUp3-N--X92Fbs--D0fn--Hx6Q-zy1", # 組織コード
779
915
  description: "test bill", # 取引説明文
780
- created_from: "2022-01-25T23:24:31.000000+09:00", # 作成日時(起点)
781
- created_to: "2016-11-01T22:58:21.000000+09:00", # 作成日時(終点)
916
+ created_from: "2017-04-21T18:37:28.000000+09:00", # 作成日時(起点)
917
+ created_to: "2021-05-08T05:36:00.000000+09:00", # 作成日時(終点)
782
918
  shop_name: "bill test shop1", # 店舗名
783
919
  shop_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # 店舗ID
784
- lower_limit_amount: 5690, # 金額の範囲によるフィルタ(下限)
785
- upper_limit_amount: 7721, # 金額の範囲によるフィルタ(上限)
786
- is_disabled: true # 支払いQRコードが無効化されているかどうか
920
+ lower_limit_amount: 6767, # 金額の範囲によるフィルタ(下限)
921
+ upper_limit_amount: 2585, # 金額の範囲によるフィルタ(上限)
922
+ is_disabled: false # 支払いQRコードが無効化されているかどうか
787
923
  ))
788
924
  ```
789
925
 
@@ -927,7 +1063,7 @@ response = $client.send(Pokepay::Request::ListBills.new(
927
1063
  response = $client.send(Pokepay::Request::CreateBill.new(
928
1064
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: 支払いマネーのマネーID
929
1065
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # shop_id: 支払い先(受け取り人)の店舗ID
930
- amount: 4286, # 支払い額
1066
+ amount: 8458, # 支払い額
931
1067
  description: "test bill" # 説明文(アプリ上で取引の説明文として表示される)
932
1068
  ))
933
1069
  ```
@@ -951,9 +1087,9 @@ response = $client.send(Pokepay::Request::CreateBill.new(
951
1087
  ```ruby
952
1088
  response = $client.send(Pokepay::Request::UpdateBill.new(
953
1089
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # bill_id: 支払いQRコードのID
954
- amount: 3562, # 支払い額
1090
+ amount: 45, # 支払い額
955
1091
  description: "test bill", # 説明文
956
- is_disabled: true # 無効化されているかどうか
1092
+ is_disabled: false # 無効化されているかどうか
957
1093
  ))
958
1094
  ```
959
1095
 
@@ -1016,9 +1152,9 @@ Cashtrayを作成します。
1016
1152
  response = $client.send(Pokepay::Request::CreateCashtray.new(
1017
1153
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
1018
1154
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # shop_id: 店舗ユーザーID
1019
- 3128, # amount: 金額
1155
+ 6575, # amount: 金額
1020
1156
  description: "たい焼き(小倉)", # 取引履歴に表示する説明文
1021
- expires_in: 8103 # 失効時間(秒)
1157
+ expires_in: 1228 # 失効時間(秒)
1022
1158
  ))
1023
1159
  ```
1024
1160
 
@@ -1179,9 +1315,9 @@ Cashtrayの内容を更新します。bodyパラメーターは全て省略可
1179
1315
  ```ruby
1180
1316
  response = $client.send(Pokepay::Request::UpdateCashtray.new(
1181
1317
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # cashtray_id: CashtrayのID
1182
- amount: 9905, # 金額
1318
+ amount: 7001, # 金額
1183
1319
  description: "たい焼き(小倉)", # 取引履歴に表示する説明文
1184
- expires_in: 2635 # 失効時間(秒)
1320
+ expires_in: 6822 # 失効時間(秒)
1185
1321
  ))
1186
1322
  ```
1187
1323
 
@@ -1287,10 +1423,10 @@ response = $client.send(Pokepay::Request::UpdateAccount.new(
1287
1423
  ```ruby
1288
1424
  response = $client.send(Pokepay::Request::ListAccountBalances.new(
1289
1425
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # account_id: ウォレットID
1290
- page: 6492, # ページ番号
1291
- per_page: 8200, # 1ページ分の取引数
1292
- expires_at_from: "2023-02-10T06:31:24.000000+09:00", # 有効期限の期間によるフィルター(開始時点)
1293
- expires_at_to: "2015-10-25T22:32:38.000000+09:00", # 有効期限の期間によるフィルター(終了時点)
1426
+ page: 2373, # ページ番号
1427
+ per_page: 451, # 1ページ分の取引数
1428
+ expires_at_from: "2023-01-18T09:59:31.000000+09:00", # 有効期限の期間によるフィルター(開始時点)
1429
+ expires_at_to: "2016-09-25T04:41:30.000000+09:00", # 有効期限の期間によるフィルター(終了時点)
1294
1430
  direction: "asc" # 有効期限によるソート順序
1295
1431
  ))
1296
1432
  ```
@@ -1365,11 +1501,11 @@ response = $client.send(Pokepay::Request::ListAccountBalances.new(
1365
1501
  ```ruby
1366
1502
  response = $client.send(Pokepay::Request::ListAccountExpiredBalances.new(
1367
1503
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # account_id: ウォレットID
1368
- page: 6728, # ページ番号
1369
- per_page: 2052, # 1ページ分の取引数
1370
- expires_at_from: "2022-12-01T19:24:55.000000+09:00", # 有効期限の期間によるフィルター(開始時点)
1371
- expires_at_to: "2017-01-20T20:17:45.000000+09:00", # 有効期限の期間によるフィルター(終了時点)
1372
- direction: "desc" # 有効期限によるソート順序
1504
+ page: 1228, # ページ番号
1505
+ per_page: 7032, # 1ページ分の取引数
1506
+ expires_at_from: "2023-02-16T15:27:38.000000+09:00", # 有効期限の期間によるフィルター(開始時点)
1507
+ expires_at_to: "2025-04-18T14:51:29.000000+09:00", # 有効期限の期間によるフィルター(終了時点)
1508
+ direction: "asc" # 有効期限によるソート順序
1373
1509
  ))
1374
1510
  ```
1375
1511
 
@@ -1437,6 +1573,114 @@ response = $client.send(Pokepay::Request::ListAccountExpiredBalances.new(
1437
1573
 
1438
1574
  ---
1439
1575
  成功したときは[PaginatedAccountBalance](#paginated-account-balance)オブジェクトを返します
1576
+ <a name="get-customer-accounts"></a>
1577
+ #### エンドユーザーのウォレット一覧を表示する
1578
+ マネーを指定してエンドユーザーのウォレット一覧を取得します。
1579
+ ```ruby
1580
+ response = $client.send(Pokepay::Request::GetCustomerAccounts.new(
1581
+ "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
1582
+ page: 4539, # ページ番号
1583
+ per_page: 2772, # 1ページ分のウォレット数
1584
+ created_at_from: "2023-12-25T19:33:57.000000+09:00", # ウォレット作成日によるフィルター(開始時点)
1585
+ created_at_to: "2020-11-16T21:21:47.000000+09:00", # ウォレット作成日によるフィルター(終了時点)
1586
+ is_suspended: true, # ウォレットが凍結状態かどうかでフィルターする
1587
+ external_id: "vjsqVkcSInvOjFPIL9qlVM", # 外部ID
1588
+ tel: "07018335-9579", # エンドユーザーの電話番号
1589
+ email: "805Swtsg2N@kJBD.com" # エンドユーザーのメールアドレス
1590
+ ))
1591
+ ```
1592
+
1593
+ ---
1594
+ `private_money_id`
1595
+ ```json
1596
+ {
1597
+ "type": "string",
1598
+ "format": "uuid"
1599
+ }
1600
+ ```
1601
+ マネーIDです。
1602
+
1603
+ 一覧するウォレットのマネーを指定します。このパラメータは必須です。
1604
+
1605
+ ---
1606
+ `page`
1607
+ ```json
1608
+ {
1609
+ "type": "integer",
1610
+ "minimum": 1
1611
+ }
1612
+ ```
1613
+ 取得したいページ番号です。デフォルト値は1です。
1614
+
1615
+ ---
1616
+ `per_page`
1617
+ ```json
1618
+ {
1619
+ "type": "integer",
1620
+ "minimum": 1
1621
+ }
1622
+ ```
1623
+ 1ページ分のウォレット数です。デフォルト値は30です。
1624
+
1625
+ ---
1626
+ `created_at_from`
1627
+ ```json
1628
+ {
1629
+ "type": "string",
1630
+ "format": "date-time"
1631
+ }
1632
+ ```
1633
+ ウォレット作成日によるフィルターの開始時点のタイムスタンプです。デフォルトでは未指定です。
1634
+
1635
+ ---
1636
+ `created_at_to`
1637
+ ```json
1638
+ {
1639
+ "type": "string",
1640
+ "format": "date-time"
1641
+ }
1642
+ ```
1643
+ ウォレット作成日によるフィルターの終了時点のタイムスタンプです。デフォルトでは未指定です。
1644
+
1645
+ ---
1646
+ `is_suspended`
1647
+ ```json
1648
+ { "type": "boolean" }
1649
+ ```
1650
+ このパラメータが指定されている場合、ウォレットの凍結状態で結果がフィルターされます。デフォルトでは未指定です。
1651
+
1652
+ ---
1653
+ `external_id`
1654
+ ```json
1655
+ {
1656
+ "type": "string",
1657
+ "maxLength": 50
1658
+ }
1659
+ ```
1660
+ 外部IDでのフィルタリングです。デフォルトでは未指定です。
1661
+
1662
+ ---
1663
+ `tel`
1664
+ ```json
1665
+ {
1666
+ "type": "string",
1667
+ "pattern": "^0[0-9]{1,3}-?[0-9]{2,4}-?[0-9]{3,4}$"
1668
+ }
1669
+ ```
1670
+ エンドユーザーの電話番号でのフィルタリングです。デフォルトでは未指定です。
1671
+
1672
+ ---
1673
+ `email`
1674
+ ```json
1675
+ {
1676
+ "type": "string",
1677
+ "format": "email"
1678
+ }
1679
+ ```
1680
+ エンドユーザーのメールアドレスでのフィルタリングです。デフォルトでは未指定です。
1681
+
1682
+ ---
1683
+ 成功したときは[PaginatedAccountWithUsers](#paginated-account-with-users)オブジェクトを返します
1440
1684
  <a name="create-customer-account"></a>
1441
1685
  #### 新規エンドユーザーウォレットを追加する
1442
1686
  指定したマネーのウォレットを作成し、同時にそのウォレットを保有するユーザも作成します。
@@ -1444,7 +1688,8 @@ response = $client.send(Pokepay::Request::ListAccountExpiredBalances.new(
1444
1688
  response = $client.send(Pokepay::Request::CreateCustomerAccount.new(
1445
1689
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
1446
1690
  user_name: "ポケペイ太郎", # ユーザー名
1447
- account_name: "ポケペイ太郎のアカウント" # アカウント名
1691
+ account_name: "ポケペイ太郎のアカウント", # アカウント名
1692
+ external_id: "WoqdLq3QmHRbZpwbP" # 外部ID
1448
1693
  ))
1449
1694
  ```
1450
1695
 
@@ -1480,8 +1725,93 @@ response = $client.send(Pokepay::Request::CreateCustomerAccount.new(
1480
1725
  ```
1481
1726
  作成するウォレット名です。省略した場合は空文字となります。
1482
1727
 
1728
+ ---
1729
+ `external_id`
1730
+ ```json
1731
+ {
1732
+ "type": "string",
1733
+ "maxLength": 50
1734
+ }
1735
+ ```
1736
+ PAPIクライアントシステムから利用するPokepayユーザーのIDです。デフォルトでは未指定です。
1737
+
1483
1738
  ---
1484
1739
  成功したときは[AccountWithUser](#account-with-user)オブジェクトを返します
1740
+ <a name="get-shop-accounts"></a>
1741
+ #### 店舗ユーザーのウォレット一覧を表示する
1742
+ マネーを指定して店舗ユーザーのウォレット一覧を取得します。
1743
+ ```ruby
1744
+ response = $client.send(Pokepay::Request::GetShopAccounts.new(
1745
+ "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
1746
+ page: 83, # ページ番号
1747
+ per_page: 5866, # 1ページ分のウォレット数
1748
+ created_at_from: "2021-03-18T09:33:18.000000+09:00", # ウォレット作成日によるフィルター(開始時点)
1749
+ created_at_to: "2019-10-15T23:24:49.000000+09:00", # ウォレット作成日によるフィルター(終了時点)
1750
+ is_suspended: false # ウォレットが凍結状態かどうかでフィルターする
1751
+ ))
1752
+ ```
1753
+
1754
+ ---
1755
+ `private_money_id`
1756
+ ```json
1757
+ {
1758
+ "type": "string",
1759
+ "format": "uuid"
1760
+ }
1761
+ ```
1762
+ マネーIDです。
1763
+
1764
+ 一覧するウォレットのマネーを指定します。このパラメータは必須です。
1765
+
1766
+ ---
1767
+ `page`
1768
+ ```json
1769
+ {
1770
+ "type": "integer",
1771
+ "minimum": 1
1772
+ }
1773
+ ```
1774
+ 取得したいページ番号です。デフォルト値は1です。
1775
+
1776
+ ---
1777
+ `per_page`
1778
+ ```json
1779
+ {
1780
+ "type": "integer",
1781
+ "minimum": 1
1782
+ }
1783
+ ```
1784
+ 1ページ分のウォレット数です。デフォルト値は30です。
1785
+
1786
+ ---
1787
+ `created_at_from`
1788
+ ```json
1789
+ {
1790
+ "type": "string",
1791
+ "format": "date-time"
1792
+ }
1793
+ ```
1794
+ ウォレット作成日によるフィルターの開始時点のタイムスタンプです。デフォルトでは未指定です。
1795
+
1796
+ ---
1797
+ `created_at_to`
1798
+ ```json
1799
+ {
1800
+ "type": "string",
1801
+ "format": "date-time"
1802
+ }
1803
+ ```
1804
+ ウォレット作成日によるフィルターの終了時点のタイムスタンプです。デフォルトでは未指定です。
1805
+
1806
+ ---
1807
+ `is_suspended`
1808
+ ```json
1809
+ { "type": "boolean" }
1810
+ ```
1811
+ このパラメータが指定されている場合、ウォレットの凍結状態で結果がフィルターされます。デフォルトでは未指定です。
1812
+
1813
+ ---
1814
+ 成功したときは[PaginatedAccountWithUsers](#paginated-account-with-users)オブジェクトを返します
1485
1815
  <a name="list-customer-transactions"></a>
1486
1816
  #### 取引履歴を取得する
1487
1817
  取引一覧を返します。
@@ -1490,10 +1820,10 @@ response = $client.send(Pokepay::Request::ListCustomerTransactions.new(
1490
1820
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
1491
1821
  sender_customer_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # 送金エンドユーザーID
1492
1822
  receiver_customer_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # 受取エンドユーザーID
1493
- type: "Srp", # 取引種別、チャージ=topup、支払い=payment、個人間送金=transfer
1494
- is_modified: false, # キャンセル済みかどうか
1495
- from: "2017-07-25T12:50:19.000000+09:00", # 開始日時
1496
- to: "2016-03-31T11:27:56.000000+09:00", # 終了日時
1823
+ type: "B6hajGJrCJ", # 取引種別、チャージ=topup、支払い=payment、個人間送金=transfer
1824
+ is_modified: true, # キャンセル済みかどうか
1825
+ from: "2019-02-13T12:10:46.000000+09:00", # 開始日時
1826
+ to: "2017-02-20T06:05:40.000000+09:00", # 終了日時
1497
1827
  page: 1, # ページ番号
1498
1828
  per_page: 50 # 1ページ分の取引数
1499
1829
  ))
@@ -1618,11 +1948,11 @@ response = $client.send(Pokepay::Request::ListShops.new(
1618
1948
  organization_code: "pocketchange", # 組織コード
1619
1949
  private_money_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # マネーID
1620
1950
  name: "oxスーパー三田店", # 店舗名
1621
- postal_code: "5102030", # 店舗の郵便番号
1951
+ postal_code: "800-9576", # 店舗の郵便番号
1622
1952
  address: "東京都港区芝...", # 店舗の住所
1623
- tel: "02-200-2918", # 店舗の電話番号
1624
- email: "fbLwdjVaS9@Jydp.com", # 店舗のメールアドレス
1625
- external_id: "qXjqW7D3u", # 店舗の外部ID
1953
+ tel: "089682-5023", # 店舗の電話番号
1954
+ email: "jlaztijN3v@ebjT.com", # 店舗のメールアドレス
1955
+ external_id: "69RjYRPCqvnZ1YzdrhGH7XKNoGDpqqjY", # 店舗の外部ID
1626
1956
  page: 1, # ページ番号
1627
1957
  per_page: 50 # 1ページ分の取引数
1628
1958
  ))
@@ -1747,11 +2077,11 @@ response = $client.send(Pokepay::Request::ListShops.new(
1747
2077
  ```ruby
1748
2078
  response = $client.send(Pokepay::Request::CreateShop.new(
1749
2079
  "oxスーパー三田店", # shop_name: 店舗名
1750
- shop_postal_code: "373-4054", # 店舗の郵便番号
2080
+ shop_postal_code: "5142087", # 店舗の郵便番号
1751
2081
  shop_address: "東京都港区芝...", # 店舗の住所
1752
- shop_tel: "083-779-345", # 店舗の電話番号
1753
- shop_email: "dPl4JIrQmL@FWJx.com", # 店舗のメールアドレス
1754
- shop_external_id: "GB9NLriuIsMTYyCUoOEa9YZaUNPTMagDSPeH", # 店舗の外部ID
2082
+ shop_tel: "0074-18354932", # 店舗の電話番号
2083
+ shop_email: "YdhYyR9ZtW@hMAK.com", # 店舗のメールアドレス
2084
+ shop_external_id: "ZHQ2Tjahc0hASAcEibjk", # 店舗の外部ID
1755
2085
  organization_code: "ox-supermarket" # 組織コード
1756
2086
  ))
1757
2087
  ```
@@ -1761,14 +2091,14 @@ response = $client.send(Pokepay::Request::CreateShop.new(
1761
2091
  ```ruby
1762
2092
  response = $client.send(Pokepay::Request::CreateShopV2.new(
1763
2093
  "oxスーパー三田店", # name: 店舗名
1764
- postal_code: "9873173", # 店舗の郵便番号
2094
+ postal_code: "5184159", # 店舗の郵便番号
1765
2095
  address: "東京都港区芝...", # 店舗の住所
1766
- tel: "0097712-9463", # 店舗の電話番号
1767
- email: "oPTyGfjAlv@bOwB.com", # 店舗のメールアドレス
1768
- external_id: "ftL3mTfJhTjDs9c8QNU", # 店舗の外部ID
2096
+ tel: "07-97912", # 店舗の電話番号
2097
+ email: "FrkXVihIdQ@Wu7J.com", # 店舗のメールアドレス
2098
+ external_id: "4NYirXryPP6taqbm6hsnA9hELka", # 店舗の外部ID
1769
2099
  organization_code: "ox-supermarket", # 組織コード
1770
- private_money_ids: ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"], # 店舗で有効にするマネーIDの配列
1771
- can_topup_private_money_ids: ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"] # 店舗でチャージ可能にするマネーIDの配列
2100
+ private_money_ids: ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"], # 店舗で有効にするマネーIDの配列
2101
+ can_topup_private_money_ids: ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"] # 店舗でチャージ可能にするマネーIDの配列
1772
2102
  ))
1773
2103
  ```
1774
2104
 
@@ -1839,12 +2169,12 @@ response = $client.send(Pokepay::Request::GetShop.new(
1839
2169
  response = $client.send(Pokepay::Request::UpdateShop.new(
1840
2170
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # shop_id: 店舗ユーザーID
1841
2171
  name: "oxスーパー三田店", # 店舗名
1842
- postal_code: "841-5932", # 店舗の郵便番号
2172
+ postal_code: "376-2080", # 店舗の郵便番号
1843
2173
  address: "東京都港区芝...", # 店舗の住所
1844
- tel: "0870057651", # 店舗の電話番号
1845
- email: "6qe5BUa3mr@tCxk.com", # 店舗のメールアドレス
1846
- external_id: "ktMbdZ0Ff5nebRZC0vDYNEW", # 店舗の外部ID
1847
- private_money_ids: ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"], # 店舗で有効にするマネーIDの配列
2174
+ tel: "041115489", # 店舗の電話番号
2175
+ email: "VIgVP7fIz1@xemn.com", # 店舗のメールアドレス
2176
+ external_id: "x9P7H", # 店舗の外部ID
2177
+ private_money_ids: ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"], # 店舗で有効にするマネーIDの配列
1848
2178
  can_topup_private_money_ids: [] # 店舗でチャージ可能にするマネーIDの配列
1849
2179
  ))
1850
2180
  ```
@@ -1962,7 +2292,7 @@ response = $client.send(Pokepay::Request::ListUserAccounts.new(
1962
2292
  指定したユーザーIDのウォレット一覧を取得します。パートナーキーと紐づく組織が発行しているマネーのウォレットのみが表示されます。
1963
2293
 
1964
2294
  ---
1965
- 成功したときは[PaginatedAccounts](#paginated-accounts)オブジェクトを返します
2295
+ 成功したときは[PaginatedAccountDetails](#paginated-account-details)オブジェクトを返します
1966
2296
  ### Private Money
1967
2297
  <a name="get-private-moneys"></a>
1968
2298
  #### マネー一覧を取得する
@@ -1995,8 +2325,8 @@ response = $client.send(Pokepay::Request::GetPrivateMoneys.new(
1995
2325
  ```ruby
1996
2326
  response = $client.send(Pokepay::Request::GetPrivateMoneyOrganizationSummaries.new(
1997
2327
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", # private_money_id: マネーID
1998
- from: "2021-10-16T13:57:56.000000+09:00", # 開始日時(toと同時に指定する必要有)
1999
- to: "2019-06-24T18:12:50.000000+09:00", # 終了日時(fromと同時に指定する必要有)
2328
+ from: "2016-05-21T23:00:33.000000+09:00", # 開始日時(toと同時に指定する必要有)
2329
+ to: "2021-05-24T13:34:12.000000+09:00", # 終了日時(fromと同時に指定する必要有)
2000
2330
  page: 1, # ページ番号
2001
2331
  per_page: 50 # 1ページ分の取引数
2002
2332
  ))
@@ -2010,10 +2340,10 @@ response = $client.send(Pokepay::Request::GetPrivateMoneyOrganizationSummaries.n
2010
2340
  CSVファイルから一括取引をします。
2011
2341
  ```ruby
2012
2342
  response = $client.send(Pokepay::Request::BulkCreateTransaction.new(
2013
- "XSVHRY4YZdsEswklf9tWgAr9K", # name: 一括取引タスク名
2014
- "jsUzeefEv", # content: 取引する情報のCSV
2015
- "U98BI4BdtnYVFOF5IXA6lNw66Yqs62ry4EX0", # request_id: リクエストID
2016
- description: "5SsjBGi2vt3IVLujfoeXIyA6Ao821XE55hc29pv4sZBooZY5wA4Og2kdAYLVTxSOsaSsUmdY0" # 一括取引の説明
2343
+ "lwWZKuWWf4n5wNPq2rjN28", # name: 一括取引タスク名
2344
+ "QfQLnQ9Qr", # content: 取引する情報のCSV
2345
+ "2gs4rAyEVt2ws7WkJzpgGUX4mtxobZ9ZCpNJ", # request_id: リクエストID
2346
+ description: "ZG6LzTWIbd8ZNVrafdiivNn4NbNLXIdoiqtrelImUNmLeKEfXUc2dQExu22E4bXnTsrAuXzc" # 一括取引の説明
2017
2347
  ))
2018
2348
  ```
2019
2349
 
@@ -2102,9 +2432,12 @@ response = $client.send(Pokepay::Request::BulkCreateTransaction.new(
2102
2432
  * `money_balance (double)`:
2103
2433
  * `point_balance (double)`:
2104
2434
  * `private_money (PrivateMoney)`:
2435
+ * `user (User)`:
2105
2436
 
2106
2437
  `private_money`は [PrivateMoney](#private-money) オブジェクトを返します。
2107
2438
 
2439
+ `user`は [User](#user) オブジェクトを返します。
2440
+
2108
2441
  <a name="bill"></a>
2109
2442
  ## Bill
2110
2443
  * `id (string)`: 支払いQRコードのID
@@ -2229,13 +2562,23 @@ response = $client.send(Pokepay::Request::BulkCreateTransaction.new(
2229
2562
 
2230
2563
  `pagination`は [Pagination](#pagination) オブジェクトを返します。
2231
2564
 
2232
- <a name="paginated-accounts"></a>
2233
- ## PaginatedAccounts
2234
- * `rows (array of Accounts)`:
2565
+ <a name="paginated-account-with-users"></a>
2566
+ ## PaginatedAccountWithUsers
2567
+ * `rows (array of AccountWithUsers)`:
2568
+ * `count (integer)`:
2569
+ * `pagination (Pagination)`:
2570
+
2571
+ `rows`は [AccountWithUser](#account-with-user) オブジェクトの配列を返します。
2572
+
2573
+ `pagination`は [Pagination](#pagination) オブジェクトを返します。
2574
+
2575
+ <a name="paginated-account-details"></a>
2576
+ ## PaginatedAccountDetails
2577
+ * `rows (array of AccountDetails)`:
2235
2578
  * `count (integer)`:
2236
2579
  * `pagination (Pagination)`:
2237
2580
 
2238
- `rows`は [Account](#account) オブジェクトの配列を返します。
2581
+ `rows`は [AccountDetail](#account-detail) オブジェクトの配列を返します。
2239
2582
 
2240
2583
  `pagination`は [Pagination](#pagination) オブジェクトを返します。
2241
2584