adapay 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7656d2c7d5ae26c68f1f6ac9625d44331ba36d258ec59f69c064a68200437b44
-  data.tar.gz: a4e47fb1654d77c8d8eafaf13483c23b2e16ff9ac149c8f7df7dc9cd9d16e277
+  metadata.gz: 413ba07cde882c6a880bb1e9b6743c770cf24063612694c50f541f7d5ec50216
+  data.tar.gz: 031d9ef98bd8c62d2e587dce4a10b24688ffb93bd9fe517068d4eaac8d31a2f5
 SHA512:
-  metadata.gz: 0eac2f1adb7e1321f10f32a081b6e3aa9c9a50186612ac04f216b29b582af61c0d6b3ea5abafd73db8ac3dfdaf46aa0df40135ec1a98d8d201d1d8135e58484e
-  data.tar.gz: f46342c812521345719cc687ca969779f70d58858dcbb1a5571eaceeb90f7763088759be4d453c77708ac884a46f0aad9743f8b086c02f572d91b42e168ad57a
+  metadata.gz: 68fdc0cdc902f471dd96d9ef62df263d02fbe0f59a5e76ff2c59ce241dfd4bcb9ff355cb1591dddc4963e2f644a550b6c1911d9664ea5c90262f3fb862c87aeb
+  data.tar.gz: dc3a89ad8e7b9882202311726970526c285ec4eb6b2a153746738214c67c7b974b7eab639a55c24de846dee6a0628b148c55c43667b969e99ee39b29127f84eb

data/.1024

@@ -0,0 +1,9 @@
+# .1024 Configuration file for project run commands, compilation and debug settings (optional);
+# Any changes made will be auto-saved and take effect immediately.
+# For more information, please refer to the documentation: https://docs.clacky.ai/clacky-workspace/configure
+
+# Command to run when "Run" button clicked
+run_command: 'bundle exec rspec'
+# Command to install or update dependencies, will execute each time a new thread created to ensure dependencies up-to-date
+dependency_command: 'bundle install'
+linter_config: []

data/.gitignore

@@ -9,3 +9,27 @@
 
 # rspec failure tracking
 .rspec_status
+
+# Ruby build artifacts
+*.gem
+
+# Local environment files
+.env
+
+# Ruby version manager files
+.ruby-version
+.ruby-gemset
+
+# Local bundle configurations
+.bundle/
+
+# Gem installation directories
+vendor/bundle/
+
+# Log files
+log/
+
+# Clacky-specific files
+.1024*
+!.1024
+.breakpoints

data/Gemfile.lock

@@ -1,13 +1,29 @@
 PATH
   remote: .
   specs:
-    adapay (1.0.0)
+    adapay (1.0.1)
+      rest-client (~> 2.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
     diff-lcs (1.5.0)
+    domain_name (0.6.20240107)
+    http-accept (1.7.0)
+    http-cookie (1.0.8)
+      domain_name (~> 0.5)
+    logger (1.7.0)
+    mime-types (3.7.0)
+      logger
+      mime-types-data (~> 3.2025, >= 3.2025.0507)
+    mime-types-data (3.2025.0610)
+    netrc (0.11.0)
     rake (12.3.3)
+    rest-client (2.1.0)
+      http-accept (>= 1.7.0, < 2.0)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
     rspec (3.11.0)
       rspec-core (~> 3.11.0)
       rspec-expectations (~> 3.11.0)

data/README.md

@@ -61,7 +61,7 @@ params = {
 res = Adapay.create_refund(params)
 ```
 
-## 1. Create Payment in other application with backup_app_id
+## 2. Create Payment in other application with backup_app_id
 
 ``` ruby
 params = {
@@ -85,6 +85,88 @@ res = Adapay.create_refund(params.merge(app_id: Adapay.backup_app_id))
 
 This Gem can auto search the `backup_app_key` from `Adapay.id_key_map`. You can check the source code from [here](https://github.com/lanzhiheng/adapay/blob/master/lib/adapay.rb#L80).
 
+### 3. Create Corporate Member
+
+To create a corporate member account, you need to provide required corporate information:
+
+``` ruby
+params = {
+  member_id: 'corp_member_001',    # Unique merchant member ID
+  order_no: 'order_no_001',        # Unique order number
+  name: 'Test Company Ltd.',       # Corporate name
+  prov_code: '310000',             # Province code
+  city_code: '310100',             # City code
+  district_code: '310101',         # District code
+  address: '123 Business Road',    # Business address
+  legal_person: '张三',            # Legal representative name
+  cert_no: '310000198001010011',   # ID card number
+  cert_type: '00',                 # ID card type
+  mobile: '13800000000',           # Contact mobile
+  email: 'test@example.com'        # Contact email
+}
+
+# Create corporate member without file attachment
+response = Adapay.create_corp_member(params)
+```
+
+#### Required Parameters
+
+| Parameter     | Description                              | Required |
+|---------------|------------------------------------------|----------|
+| member_id     | Merchant's unique identifier             | Yes      |
+| order_no      | Unique order number                      | Yes      |
+| name          | Corporate name                           | Yes      |
+| prov_code     | Province code                            | Yes      |
+| city_code     | City code                                | Yes      |
+| district_code | District code                            | Yes      |
+| address       | Business address                         | Yes      |
+| legal_person  | Legal representative name                | Yes      |
+| cert_no       | ID card number of legal representative   | Yes      |
+| cert_type     | ID card type                             | Yes      |
+| mobile        | Contact mobile phone                     | Yes      |
+| email         | Contact email                            | Yes      |
+
+#### File Upload
+
+You can attach corporate documentation files (business license, etc.) when creating a member:
+
+``` ruby
+# Path to attachment file
+attach_file_path = '/path/to/business_license.jpg'
+
+# Create corporate member with file attachment
+response = Adapay.create_corp_member(params, attach_file_path)
+```
+
+The file will be uploaded using multipart/form-data format. The system supports common image formats such as PNG, JPG, JPEG, etc.
+
+#### Response Handling
+
+``` ruby
+# Parse the JSON response
+result = JSON.parse(response)
+
+if result['result_code'] == '200' && result['biz_result_code'] == 'S'
+  # Success case
+  member_id = result['data']['member_id']
+  puts "Corporate member created successfully: #{member_id}"
+else
+  # Error handling
+  error_code = result['biz_result_code']
+  error_msg = result['biz_msg']
+  puts "Failed to create corporate member: #{error_msg} (#{error_code})"
+end
+```
+
+#### Query Corporate Member
+
+You can query a corporate member's information using its member_id:
+
+``` ruby
+# Query corporate member details
+response = Adapay.query_corp_member(member_id: 'corp_member_001')
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/adapay. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/adapay/blob/master/CODE_OF_CONDUCT.md).
@@ -96,4 +178,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Adapay project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/adapay/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Adapay project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/adapay/blob/master/CODE_OF_CONDUCT.md).

data/adapay.gemspec

@@ -28,4 +28,6 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'rest-client', '~> 2.1'
 end

data/lib/adapay/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Adapay
-  VERSION = '1.0.0'
+  VERSION = '1.2.0'
 end

data/lib/adapay.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 require 'adapay/version'
+require 'rest-client'
+require 'json'
+
+# 汇付最新文档： https://doc.adapay.tech/document/api/#/member?id=%e5%88%9b%e5%bb%ba%e4%bc%81%e4%b8%9a%e7%94%a8%e6%88%b7%e5%af%b9%e8%b1%a1
 
 module Adapay
   class << self
@@ -116,6 +120,8 @@ module Adapay
     def query_refund(params)
       path = '/v1/payments/refunds'
 
+      params = { app_id: app_id }.merge(params)
+
       send_request(:get, path, params)
     end
 
@@ -162,6 +168,17 @@ module Adapay
       send_request(:post, path, params)
     end
 
+    # 必填：tel_no 用户手机号 user_name 用户姓名 cert_type 00-身份证 cert_id 证件号
+    def create_realname_member(params)
+      path = '/v1/members/realname'
+
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      send_request(:post, path, params)
+    end
+
     # https://docs.adapay.tech/api/trade.html#id39
     def query_member(params)
       member_id = params.delete(:member_id)
@@ -187,16 +204,14 @@ module Adapay
     end
 
     # https://docs.adapay.tech/api/trade.html#id42
-    def query_member_list
+    def query_member_list(**params)
       path = '/v1/members/list'
 
-      params = { app_id: app_id }
+      params = { app_id: app_id }.merge(params)
 
       send_request(:get, path, params)
     end
 
-    ## ---
-
     def create_settle_account(params)
       path = '/v1/settle_accounts'
 
@@ -259,6 +274,40 @@ module Adapay
       send_request(:get, path, params)
     end
 
+    # -- 余额支付
+
+    def balance_pay(params)
+      path = '/v1/settle_accounts/balancePay'
+
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      send_request(:post, path, params)
+    end
+
+    def balance_refund(params)
+      path = '/v1/settle_accounts/balanceRefund'
+
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      send_request(:post, path, params)
+    end
+
+    # Adapay.balance_pay_list({ created_gte: (Date.yesterday.beginning_of_day.to_f * 1000).to_i,
+    #                           created_lte: (Date.yesterday.end_of_day.to_f * 1000).to_i })
+    def balance_pay_list(params)
+      path = '/v1/settle_accounts/balancePayList'
+
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      send_request(:get, path, params)
+    end
+
     # -- 钱包
 
     def cash(params)
@@ -301,10 +350,10 @@ module Adapay
       send_request(:get, path, params)
     end
 
-    def query_payment_reverse_list
+    def query_payment_reverse_list(params)
       params = {
         app_id: app_id
-      }
+      }.merge(params)
 
       path = '/v1/payments/reverse/list'
       send_request(:get, path, params)
@@ -321,6 +370,24 @@ module Adapay
       send_request(:post, path, params)
     end
 
+    def payment_confirm_reverse(params)
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      path = '/v1/payments/confirm/reverse'
+      send_request(:post, path, params)
+    end
+
+    def query_payment_confirm_reverse_detail(params)
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      path = '/v1/payments/confirm/reverse/details'
+      send_request(:get, path, params)
+    end
+
     # https://docs.adapay.tech/api/trade.html#id59
     def query_payment_confirm(params)
       payment_confirm_id = params.delete(:payment_confirm_id)
@@ -344,6 +411,62 @@ module Adapay
       send_request(:get, path, params)
     end
 
+    def corp_picture_upload(params, attach_file)
+      required_fields = [:file_type]
+
+      raise ArgumentError, 'missing required parameters' if params.empty?
+
+      required_fields.each do |field|
+        raise ArgumentError, "#{field} is required" unless params.key?(field)
+      end
+
+      path = '/v1/corp/pictureUpload'
+
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      # 带文件上传的接口会比较特殊：https://docs.adapay.tech/help/console.html#generatecert
+      url = endpoint + path
+      headers = build_request_info(:get, url, params)
+      url += "?#{get_original_str(params)}"
+
+      payload = { attach_file: File.new(attach_file, 'rb') }
+      RestClient::Request.execute(method: :post, url: url, headers: headers, payload: payload)
+    end
+
+    # -- 企业用户
+
+    # https://docs.adapay.tech/api/trade.html#corp-member-create
+    def create_corp_member(params)
+      # Validate required parameters
+      required_fields = %i[member_id order_no name]
+      raise ArgumentError, 'missing required parameters' if params.empty?
+
+      required_fields.each do |field|
+        raise ArgumentError, "#{field} is required" unless params.key?(field)
+      end
+
+      path = '/v1/corp/createMembers'
+
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      send_request(:post, path, params)
+    end
+
+    # Query an existing corporate member
+    def query_corp_member(params)
+      path = "/v1/corp_members/#{params[:member_id]}"
+
+      params = {
+        app_id: app_id
+      }.merge(params)
+
+      send_request(:get, path, params)
+    end
+
     private
 
     def send_request(method, path, params)

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: adapay
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - lanzhiheng
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-07-28 00:00:00.000000000 Z
-dependencies: []
+date: 2025-06-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
 description: Gem for Adapay
 email:
 - lanzhihengrj@gmail.com
@@ -17,6 +31,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".1024"
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"