Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào
tài liệu Apigee X. thông tin
Để quản lý số dư trong tài khoản trả trước, bạn có thể:
- Xem số dư hiện tại trong tài khoản trả trước. Xem phần Xem số dư tài khoản trả trước bằng API.
- Nạp tiền (thêm tiền vào) số dư tài khoản khi cần bằng cách sử dụng một nhà cung cấp dịch vụ thanh toán bên thứ ba, chẳng hạn như Worldpay. Xem phần Quản lý số dư trả trước bằng nhà cung cấp dịch vụ thanh toán bên thứ ba.
Ngoài ra, bạn có thể quản lý việc nạp lại bằng cách theo dõi các khoản thanh toán theo cách thủ công hoặc thông qua một hệ thống thanh toán tích hợp, sau đó gọi API kiếm tiền để nạp lại tài khoản, như mô tả trong phần Quản lý số dư trả trước theo cách thủ công.
- Thiết lập tính năng tự động nạp tiền khi số dư tài khoản trả trước giảm xuống dưới một ngưỡng nhất định bằng cách sử dụng API kiếm tiền và một nhà cung cấp dịch vụ thanh toán bên thứ ba, chẳng hạn như Worldpay. Lựa chọn này rất hữu ích để quản lý các khoản thanh toán định kỳ cho gói cước. Để biết thông tin, hãy xem phần Thiết lập tính năng tự động nạp lại số dư tài khoản trả trước bằng API.
Làm cách nào để tính số dư tài khoản trả trước còn lại?
Khi xem số dư tài khoản trả trước của một nhà phát triển hoặc công ty (như mô tả trong các phần sau), bạn cần lấy các giá trị sau từ phản hồi:
amount: Tổng số tiền có sẵn cho kỳ thanh toán hiện tại. Giá trị này sẽ được cập nhật khi bạn nạp lại tiền vào tài khoản trả trước bằng các phương thức được mô tả trong phần này.usage: Tổng số tiền đã sử dụng trong kỳ thanh toán hiện tại. Giá trị này được cập nhật theo từng giao dịch đủ điều kiện kiếm tiền hoặc bằng cách phát hành khoản tín dụng (dương hoặc âm).
Bạn có thể tính số dư còn lại trong tài khoản trả trước cho kỳ thanh toán hiện tại bằng cách trừ giá trị usage cho giá trị amount. Ví dụ: nếu giá trị amount là 335, 50 và giá trị usage là 34, thì số dư còn lại sẽ được tính như sau:
amount(335.50) - usage(34) = 229.50Xem số dư tài khoản trả trước bằng API
Các phần sau đây mô tả cách xem số dư tài khoản trả trước của nhà phát triển hoặc công ty bằng API.
Xem số dư tài khoản trả trước của nhà phát triển
Để xem số dư tài khoản trả trước của một nhà phát triển, hãy gửi yêu cầu GET đến một trong các API sau, trong đó {developer_id} là địa chỉ email của nhà phát triển:
/mint/organizations/{org_name}/developers/{developer_id}/developer-balances: Trả về số dư tài khoản trả trước và thông tin thiết lập định kỳ cho nhà phát triển./mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: Trả về thông tin về số dư tài khoản trả trước, bao gồm số dư hiện tại và tổng số dư, mức sử dụng, số tiền nạp và thuế sử dụng.
Bạn có thể truyền các tham số truy vấn sau để lọc kết quả:
| Tham số truy vấn | Mô tả |
|---|---|
all |
Cờ chỉ định có trả về tất cả các gói API hay không. Nếu được đặt thành false, số lượng gói API được trả về trên mỗi trang sẽ do tham số truy vấn size xác định. Giá trị mặc định là false. |
size |
Số lượng gói API được trả về trên mỗi trang. Giá trị mặc định là 20. Nếu bạn đặt tham số truy vấn all thành true, thì tham số này sẽ bị bỏ qua. |
page |
Số trang mà bạn muốn trả về (nếu nội dung được phân trang). Nếu bạn đặt tham số truy vấn all thành true, thì tham số này sẽ bị bỏ qua. |
currencyId |
Mã nhận dạng của đơn vị tiền tệ mà bạn muốn xem số dư tài khoản trả trước. |
Ví dụ:
$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password
Sau đây là ví dụ về phản hồi:
{ "developerBalance": [ { "amount": 2005, "chargePerUsage": false, "id": "your-provider-id", "isRecurring": false, "supportedCurrency": { "description": "United States Dollars", "displayName": "United States Dollars", "id": "usd", "name": "USD", "organization": { "address": [ { "address1": "10 Almaden Blvd.", "city": "San Jose", "country": "US", "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61", "isPrimary": true, "state": "CA", "zip": "95113" } ], "approveTrusted": false, "approveUntrusted": false, "billingCycle": "CALENDAR_MONTH", "country": "US", "currency": "USD", "description": "my-org", "groupOrganization": false, "hasBillingAdjustment": false, "hasBroker": false, "hasSelfBilling": false, "hasSeparateInvoiceForProduct": false, "id": "my-org", "issueNettingStmt": false, "name": "my-org", "nettingStmtPerCurrency": false, "selfBillingAsExchOrg": false, "selfBillingForAllDev": false, "separateInvoiceForFees": false, "status": "ACTIVE", "supportedBillingType": "BOTH", "taxModel": "HYBRID", "timezone": "UTC" }, "status": "ACTIVE", "virtualCurrency": false }, "usage": 2.1572 } ], "totalRecords": 1 }
Xem số dư tài khoản trả trước của một công ty
Để xem số dư tài khoản trả trước của một công ty, hãy gửi yêu cầu GET đến /mint/organizations/{org_name}/companies/{company_id}/developer-balances, trong đó {company_id} là mã nhận dạng của công ty. Nếu công ty trả trước, yêu cầu sẽ truy xuất số dư tài khoản trả trước hiện tại. Nếu công ty sử dụng gói trả sau, yêu cầu sẽ truy xuất hạn mức tín dụng hiện tại.
Bạn có thể truyền các tham số truy vấn sau để lọc kết quả:
| Tham số truy vấn | Mô tả |
|---|---|
all |
Cờ chỉ định có trả về tất cả các gói API hay không. Nếu được đặt thành false, số lượng gói API được trả về trên mỗi trang sẽ do tham số truy vấn size xác định. Giá trị mặc định là false. |
size |
Số lượng gói API được trả về trên mỗi trang. Giá trị mặc định là 20. Nếu bạn đặt tham số truy vấn all thành true, thì tham số này sẽ bị bỏ qua. |
page |
Số trang mà bạn muốn trả về (nếu nội dung được phân trang). Nếu bạn đặt tham số truy vấn all thành true, thì tham số này sẽ bị bỏ qua. |
currencyId |
Mã nhận dạng của đơn vị tiền tệ mà bạn muốn xem số dư tài khoản trả trước. |
Ví dụ:
$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password
Phản hồi này tương tự như phản hồi nêu trên, khi xem số dư tài khoản trả trước của một nhà phát triển.
Quản lý số dư tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán
Quản lý số dư tài khoản trả trước bằng cách thiết lập tài khoản nhà bán hàng với một nhà cung cấp dịch vụ thanh toán bên thứ ba, chẳng hạn như Worldpay. Hình sau đây cho thấy cách quản lý số dư tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán Worldpay.

Bảng sau đây mô tả từng bước trong quy trình quản lý số dư tài khoản trả trước, như minh hoạ ở trên.
| Bước | Mô tả |
|---|---|
| 0 |
Các bước bắt buộc Là nhà cung cấp API, để thiết lập một nhà cung cấp dịch vụ thanh toán bên thứ ba (chẳng hạn như Worldpay), bạn phải: |
| 1 |
Để kích hoạt quy trình, người dùng API thực hiện một trong các thao tác sau trong cổng thông tin dành cho nhà phát triển:
|
| 2 | Cổng thông tin cho nhà phát triển bắt đầu thanh toán thông qua Edge cho nhà phát triển, cùng với mã nhận dạng nhà cung cấp, số tiền nạp lại và đơn vị tiền tệ. Để biết thông tin về cách sử dụng API để bắt đầu thanh toán, hãy xem phần Bắt đầu thanh toán cho tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán. |
| 3 | Edge tìm nhà cung cấp theo mã nhận dạng và xác định đó là tài khoản Worldpay. |
| 4 | Edge tạo mã đặt hàng. |
| 5 | Edge tạo yêu cầu thanh toán trên Worldpay. |
| 6 | Worldpay trả về một mã tham chiếu cho đơn đặt hàng và một URL có giới hạn thời gian để thực hiện đơn đặt hàng đó. |
| 7 |
Phản hồi của Worldpay được chuyển đổi thành một phản hồi chung của Edge /payment API. Phản hồi này được trả về cổng thông tin cho nhà phát triển để hoàn tất lệnh gọi được bắt đầu ở bước 2. Ví dụ:
{
"isRecurring": "false",
"orderCode": "1234",
"referenceId": "3042815493",
"referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
"success": "true"
}
|
| 8 | Cổng thông tin cho nhà phát triển sẽ thêm các URL gọi lại (để biết trạng thái thành công, thất bại, v.v.) dưới dạng tham số truy vấn vào URL. |
| 9 | Cổng thông tin cho nhà phát triển phản hồi yêu cầu ở bước 1 bằng cách chuyển hướng trình duyệt của người dùng API đến URL đã sửa đổi. |
| 10 | Người dùng API hoàn tất biểu mẫu đăng ký và bắt đầu xử lý với Worldpay. |
| 11 | Worldpay thu thập thông tin thanh toán và xử lý khoản thanh toán. Khi thành công, Worldpay sẽ tạo Mã xác thực thông báo (MAC) bằng MAC Secret được định cấu hình trên cả Worldpay và cổng thông tin dành cho nhà phát triển. |
| 12 | Worldpay chuyển hướng trình duyệt của người dùng API đến URL gọi lại thành công (từ bước 8), nối MAC dưới dạng một tham số truy vấn và số tiền. |
| 13 | Trình duyệt gọi URL trên cổng thông tin cho nhà phát triển với số tiền và địa chỉ MAC được yêu cầu. |
| 14 | Cổng thông tin xác minh MAC dựa trên khoá bí mật MAC. MAC ngăn người dùng tuỳ ý tuyên bố rằng họ đã thanh toán thành công. |
| 15 | Cổng thông tin cho nhà phát triển gửi yêu cầu đến Edge để tải lại số dư tài khoản trả trước. Để biết thông tin về cách sử dụng API để nạp lại số dư tài khoản, hãy xem phần Nạp lại số dư tài khoản trả trước bằng API. |
Các phần sau đây mô tả các bước cần thiết để quản lý số dư trả trước bằng nhà cung cấp dịch vụ thanh toán bên thứ ba:
- Thiết lập tài khoản nhà bán hàng với nhà cung cấp dịch vụ thanh toán Worldpay
- Định cấu hình nhà cung cấp dịch vụ thanh toán trong Edge
- Xem các nhà cung cấp dịch vụ thanh toán được định cấu hình cho tổ chức của bạn
- Bật và định cấu hình các mô-đun bắt buộc trong cổng thông tin dành cho nhà phát triển
- Bắt đầu thanh toán vào tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán
- Nạp lại số dư tài khoản trả trước bằng API
- Xoá nhà cung cấp dịch vụ thanh toán bên thứ ba
Thiết lập tài khoản nhà bán hàng với nhà cung cấp dịch vụ thanh toán Worldpay
Trước khi bắt đầu, bạn phải liên hệ với một nhà cung cấp dịch vụ thanh toán bên thứ ba (Worldpay) để thiết lập(các) tài khoản nhà bán hàng. Bạn nên thiết lập hai tài khoản, một tài khoản để thử nghiệm và một tài khoản để sản xuất. Để biết thêm thông tin về tài khoản người bán Worldpay, hãy xem www.worldpay.com và wp-support.crm.worldpay.com (Trung tâm hỗ trợ của Worldpay).
Sau khi bạn thiết lập tài khoản nhà bán hàng và nhận được thông tin đăng nhập tài khoản, hãy làm theo các bước sau để định cấu hình tài khoản nhà bán hàng của bạn với Worldpay:
- Truy cập vào https://secure.worldpay.com/sso/public/auth/login.html.
- Đăng nhập vào tài khoản Worldpay bằng thông tin đăng nhập do Worldpay cung cấp cho bạn.
- Đặt mật khẩu XML và khoá bí mật mã xác thực thông điệp (MAC):
- Nhấp vào Hồ sơ.
- Đặt mật khẩu để sử dụng khi định cấu hình nhà cung cấp dịch vụ thanh toán Worldpay trong Edge trong trường XML Password (Mật khẩu XML).
- Nhập khoá bí mật MAC từ 20 đến 30 ký tự vào trường Redirect MAC secret (Khoá bí mật MAC chuyển hướng).
- Nhấp vào Lưu hồ sơ
- Thêm máy chủ quản lý Apigee Edge vào danh sách IP của người bán (danh sách cho phép):
- Nhấp vào Hồ sơ > Môi trường của người bán.
- Nhấp vào IP kiểm thử mới.
- Nhập IP cho máy chủ quản lý Apigee Edge.
- Nhấp vào Lưu.
- Định cấu hình URL của người bán để thêm các tham số Worldpay, bao gồm cả mã xác thực phương thức (MAC):
- Nhấp vào Installations > Hosted Payment Pages > Payment Page Designer (Cài đặt > Trang thanh toán được lưu trữ > Trình thiết kế trang thanh toán).
- Trong phần Chỉnh sửa trang thanh toán, hãy chọn mã nhận dạng lượt cài đặt của bạn trong danh sách thả xuống Chọn kênh.
- Trên thẻ Thuộc tính, hãy chọn Chỉnh sửa cấu hình người bán.
- Đặt giá trị Gửi thông số URL thành True.
- Nhấp vào thẻ Xuất bản.
- Thúc đẩy các thay đổi như sau:
- Đối với môi trường kiểm thử, hãy nhấp vào Promote (Xúc tiến) trong mục Design (Thiết kế) để xúc tiến từ Thiết kế sang Hộp cát.
- Đối với môi trường phát hành công khai, hãy nhấp vào Quảng bá trong Hộp cát để quảng bá từ Hộp cát lên Kênh phát hành công khai.
Định cấu hình nhà cung cấp dịch vụ thanh toán trong Edge
Bước tiếp theo là định cấu hình nhà cung cấp dịch vụ thanh toán trong Edge.
Bạn có thể định cấu hình nhà cung cấp dịch vụ thanh toán cho một tổ chức cụ thể bằng cách sử dụng API sau:
/organizations/{org-name}/providersChỉ khách hàng Apigee Edge Private Cloud có đặc quyền quản trị viên hệ thống mới có thể tuỳ ý định cấu hình nhà cung cấp dịch vụ thanh toán toàn cầu bằng API sau:
/config/providers
Khi gọi từng API, bạn phải chỉ định thông tin sau trong nội dung yêu cầu:
| Tham số | Nội dung mô tả | Bắt buộc |
authType |
Mã nhận dạng lượt cài đặt do nhà cung cấp dịch vụ thanh toán cung cấp. | Có |
credential |
Thông tin đăng nhập được mã hoá Base64 (username:XMLpassword) cho tài khoản nhà bán hàng Worldpay của bạn; username tương đương với mã người bán (viết hoa toàn bộ) và XMLpassword chỉ định mật khẩu XML mà bạn đã đặt ở bước trước khi thiết lập tài khoản nhà bán hàng Worldpay. |
Có |
description |
Nội dung mô tả về nhà cung cấp dịch vụ thanh toán. | Không |
endpoint |
Điểm cuối để truy cập vào nhà cung cấp dịch vụ thanh toán
|
Có |
merchantCode |
Mã người bán do nhà cung cấp dịch vụ thanh toán cung cấp cho người dùng API | Có |
name |
Tên dùng cho nhà cung cấp.
Chỉ dành cho khách hàng Apigee Edge Private Cloud: Đối với các nhà cung cấp dịch vụ thanh toán toàn cầu, hãy đảm bảo rằng tên này là duy nhất trên tất cả các tổ chức Edge. Bạn nên thêm WorldPay (không phân biệt chữ hoa chữ thường) vào tên nhà cung cấp để dễ dàng xác định. Ví dụ: |
Có |
Ví dụ: lệnh sau đây thiết lập một tài khoản nhà bán hàng có Worldpay tên là Worldpay-myorg:
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Worldpay-myorg",
"description": "Worldpay payment provider",
"endpoint": "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
"authType": "123456",
"credential": "dXNlcm5hbWU6cGFzc3dvcmQ=",
"merchantCode": "myMerchantCode"
}' \
"https://api.enterprise.apigee.com/v1/organizations/myOrg/providers" \
-u email:password
Xem nhà cung cấp dịch vụ thanh toán bên thứ ba
Xem và xác nhận các nhà cung cấp dịch vụ thanh toán bên thứ ba được định cấu hình cho tổ chức Edge của bạn bằng cách đưa ra yêu cầu GET cho tài nguyên sau:
/mint/organizations/{org-name}/providers
Ví dụ: sau đây cho thấy các nhà cung cấp dịch vụ thanh toán bên thứ ba hiện được định cấu hình cho myorg:
$ curl -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers" \ -u email:password
Sau đây là ví dụ về phản hồi cho thấy 2 tài khoản người bán, một tài khoản để kiểm thử và một tài khoản để sản xuất.
{
"provider" : [ {
"authType" : "123456",
"credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
"description" : "Worldpay payment provider",
"endpoint" : "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
"id" : "worldpay-myorg",
"merchantCode" : "MERCH_CODE",
"name" : "Worldpay-myorg"
}, {
"authType" : "123456",
"credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
"description" : "Worldpay payment provider",
"endpoint" : "https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp",
"id" : "worldpay-test",
"merchantCode" : "MERCH_CODE_FROM_PROVIDER",
"name" : "Worldpay-test"
} ]
}
Bật và định cấu hình các mô-đun Kiếm tiền và Worldpay trong cổng thông tin dành cho nhà phát triển
Bật các mô-đun Kiếm tiền và Worldpay bắt buộc trong cổng thông tin dành cho nhà phát triển. Để biết thông tin chi tiết, hãy xem phần Định cấu hình tính năng kiếm tiền trong Cổng thông tin dành cho nhà phát triển.
Bắt đầu thanh toán vào tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán
Như minh hoạ trong bước 2 của quy trình quản lý tài khoản trả trước, cổng thông tin cho nhà phát triển sẽ bắt đầu thanh toán cho tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán khi người tiêu dùng API:
- Chấp nhận gói cước nhưng không có đủ tiền trong tài khoản trả trước
- Yêu cầu nạp tiền vào tài khoản trả trước của họ.
Để bắt đầu thanh toán từ một nhà cung cấp dịch vụ thanh toán bên thứ ba bằng API, hãy gửi yêu cầu POST đến tài nguyên sau, trong đó {developer_id} là địa chỉ email của nhà phát triển.
/mint/organizations/{org_name}/developers/{developer_id}/payment?amount={amount}&provider={providerId}&supportedCurrencyId={currency}
Khi đưa ra yêu cầu, bạn cần chỉ định các giá trị sau làm tham số truy vấn:
- Số tiền cần thêm vào số dư tài khoản trả trước (
amount={amount}) - Mã nhận dạng nhà cung cấp dịch vụ thanh toán (
provider={providerId}) - Đơn vị tiền tệ được hỗ trợ (
supportedCurrencyId={currency})
Ngoài ra, bạn cần phải truyền các thông tin cơ bản về tài khoản, chẳng hạn như địa chỉ thanh toán của công ty.
Ví dụ: mã sau đây sẽ nạp lại số dư tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán Worldpay. Khoản tiền chuyển ban đầu vào tài khoản trả trước của bạn sẽ là 10 USD (tham số truy vấn amount được đặt thành 10).
$ curl -H "Content-Type:application/xml" -X POST -d \
'{
"address1": "5115 Hopyard Ave.",
"city": "Pleasanton",
"country": "US",
"state": "CA",
"zip": "58158"
}'
' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/payment?amount=10&provider=worldpay-myorg&supportedCurrencyId=usd" \
-u email:password
Sau đây là ví dụ về phản hồi:
{
"isRecurring": "false",
"orderCode": "1234",
"referenceId": "3042815493",
"referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
"success": "true"
}
URL đến trang Thanh toán an toàn của Worldpay được trả về trong referenceUrl cùng với khoá đơn đặt hàng duy nhất của bạn được thêm dưới dạng tham số truy vấn.
Nạp lại số dư tài khoản trả trước bằng API
Như trong bước 15 của quy trình quản lý tài khoản trả trước, sau khi xác minh rằng nhà cung cấp dịch vụ thanh toán đã xử lý thành công, cổng thông tin dành cho nhà phát triển sẽ gửi yêu cầu đến Edge để tải lại tài khoản trả trước.
Bạn có thể nạp lại số dư tài khoản trả trước bằng API cho nhà phát triển hoặc công ty, như mô tả trong các phần sau.
Nạp lại số dư tài khoản trả trước cho nhà phát triển
Để nạp lại số dư tài khoản trả trước cho nhà phát triển bằng API, hãy gửi yêu cầu POST đến /mint/organizations/{org_name}/developers/{developer_id}/developer-balances, trong đó {developer_id} là địa chỉ email của nhà phát triển. Khi đưa ra yêu cầu, bạn cần chỉ định số tiền cần thêm vào số dư và đơn vị tiền tệ được sử dụng trong nội dung yêu cầu.
Ví dụ: yêu cầu sau đây sẽ thêm 1.000 USD vào số dư tài khoản trả trước của nhà phát triển:
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"amount": 1000,
"supportedCurrency": {
"id": "usd"
}
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password
Để biết nội dung mô tả về các thuộc tính yêu cầu, hãy xem phần Tóm tắt các thuộc tính yêu cầu để nạp lại tiền vào tài khoản trả trước.
Nạp lại số dư tài khoản trả trước của một công ty
Để nạp lại số dư tài khoản trả trước cho một công ty bằng API, hãy gửi yêu cầu POST đến /mint/organizations/{org_name}/companies/{company_id}/developer-balances, trong đó {company_id} là mã nhận dạng của công ty. Khi đưa ra yêu cầu, bạn cần chỉ định số tiền cần thêm vào số dư và đơn vị tiền tệ được sử dụng trong nội dung yêu cầu.
Ví dụ: yêu cầu sau đây sẽ thêm 1.000 USD vào số dư tài khoản trả trước của một công ty:
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"amount": 1000,
"supportedCurrency": {
"id": "usd"
}
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password
Để biết nội dung mô tả về các thuộc tính yêu cầu, hãy xem phần Tóm tắt các thuộc tính yêu cầu để nạp lại tiền vào tài khoản trả trước.
Tóm tắt các thuộc tính yêu cầu để nạp lại tài khoản trả trước
Bạn phải chỉ định các thuộc tính sau đây khi nạp lại số dư tài khoản trả trước bằng API:
| Tên | Mô tả | Mặc định | Bắt buộc? |
|---|---|---|---|
amount |
Số tiền được áp dụng cho số dư trả trước (bằng đơn vị tiền tệ áp dụng). |
Không áp dụng | Có |
supportedCurrency |
Đơn vị tiền tệ dùng cho số dư trả trước. Đây là đơn vị tiền tệ được thiết lập cho gói trong gói API mà nhà phát triển đã mua. |
Không áp dụng | Có |
Xoá nhà cung cấp dịch vụ thanh toán bên thứ ba
Bạn có thể xoá nhà cung cấp dịch vụ thanh toán bên thứ ba được định cấu hình cho tổ chức Edge của mình bằng cách đưa ra yêu cầu XOÁ đối với tài nguyên sau:
Để xoá một nhà cung cấp dịch vụ thanh toán cho một tổ chức cụ thể, hãy sử dụng API sau:
/mint/organizations/{org-name}/providers/idChỉ khách hàng Apigee Edge Private Cloud có đặc quyền quản trị hệ thống mới có thể tuỳ ý xoá nhà cung cấp dịch vụ thanh toán toàn cầu bằng API sau:
/config/providers/id
Ví dụ: lệnh sau đây sẽ xoá các nhà cung cấp dịch vụ thanh toán bên thứ ba hiện được định cấu hình cho myorg:
$ curl -X DELETE \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers/worldpay-myorg" \ -u email:password
Quản lý số dư tài khoản trả trước theo cách thủ công
Ngoài ra, bạn có thể quản lý việc nạp lại số dư trả trước bằng cách theo dõi các khoản thanh toán theo cách thủ công hoặc thông qua một hệ thống thanh toán tích hợp, sau đó gọi API kiếm tiền để nạp lại tài khoản, như mô tả trong phần Nạp lại số dư tài khoản trả trước bằng API.
Thiết lập tính năng tự động nạp tiền vào số dư tài khoản trả trước bằng API
Các phần sau đây mô tả cách thiết lập tính năng tự động nạp lại số dư tài khoản trả trước cho nhà phát triển hoặc công ty sử dụng nhà cung cấp dịch vụ thanh toán bên thứ ba. Lựa chọn này hữu ích để quản lý các khoản thanh toán định kỳ cho gói thuê bao.
Thiết lập tính năng tự động nạp tiền vào tài khoản trả trước cho nhà phát triển
Để thiết lập chế độ tự động nạp tiền vào số dư tài khoản trả trước của nhà phát triển khi số dư giảm xuống dưới một ngưỡng nhất định, hãy gửi yêu cầu POST đến /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup, trong đó {developer_id} là địa chỉ email của nhà phát triển.
Khi đưa ra yêu cầu, bạn cần chỉ định những thông tin sau:
- Mã nhận dạng của nhà cung cấp dịch vụ thanh toán dùng để nạp lại tài khoản (
providerID) - Cờ cho phép tự động nạp tiền (
isRecurring) - Ngưỡng mà số dư tài khoản trả trước phải giảm xuống dưới để kích hoạt tính năng tự động nạp tiền (
replenishAmount) - Số tiền cần tự động thêm vào tài khoản (
recurringAmount) - Tham số truy vấn
supportedCurrencyIDđể chỉ định đơn vị tiền tệ.
Trong ví dụ sau, khi số dư tài khoản trả trước của nhà phát triển giảm xuống dưới 5 USD, 10 USD nữa sẽ tự động được thêm vào tài khoản.
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"providerId": "worldpay-myorg",
"isRecurring" : true,
"replenishAmount" : 5,
"recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password
Để biết nội dung mô tả về các thuộc tính yêu cầu, hãy xem Tóm tắt các thuộc tính yêu cầu để thiết lập tính năng tự động nạp lại cho tài khoản trả trước.
Thiết lập chế độ tự động nạp tiền vào số dư tài khoản trả trước cho một công ty
Để thiết lập chế độ tự động nạp tiền vào số dư tài khoản trả trước của một công ty khi số dư giảm xuống dưới một mức nhất định, hãy gửi một yêu cầu POST đến /mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup, trong đó {company_id} là mã nhận dạng của công ty.
Khi đưa ra yêu cầu, bạn cần chỉ định những thông tin sau:
- Mã nhận dạng của nhà cung cấp dịch vụ thanh toán dùng để nạp lại tài khoản (
providerID) - Cờ cho phép tự động nạp lại (
isRecurring) - Ngưỡng mà số dư tài khoản trả trước phải giảm xuống dưới để kích hoạt tính năng tự động nạp tiền (
replenishAmount) - Số tiền cần tự động thêm vào tài khoản (
recurringAmount) - Tham số truy vấn
supportedCurrencyIDđể chỉ định đơn vị tiền tệ.
Trong ví dụ sau, khi số dư tài khoản trả trước của công ty giảm xuống dưới 5 USD, 10 USD nữa sẽ tự động được thêm vào tài khoản.
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"providerId": "worldpay-myorg",
"isRecurring" : true,
"replenishAmount" : 5,
"recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password
Để biết nội dung mô tả về các thuộc tính yêu cầu, hãy xem Tóm tắt các thuộc tính yêu cầu để thiết lập tính năng tự động nạp lại cho tài khoản trả trước.
Tóm tắt các thuộc tính của yêu cầu để thiết lập chế độ tự động nạp tiền cho tài khoản trả trước
Bạn có thể chỉ định các thuộc tính sau khi tự động nạp lại số dư tài khoản trả trước bằng API.
| Tên | Mô tả | Mặc định | Bắt buộc? |
|---|---|---|---|
providerId |
Mã nhận dạng của nhà cung cấp dịch vụ thanh toán. |
Không áp dụng | Có |
chargePerUsage |
false | Không | |
isRecurring |
Cờ chỉ định việc bạn có bật tính năng tự động nạp tiền hay không ( |
Không áp dụng | Có |
replenishAmount |
Ngưỡng mà số dư tài khoản trả trước phải giảm xuống dưới để kích hoạt tính năng tự động nạp tiền. |
Không áp dụng | Có |
recurringAmount |
Số tiền sẽ được nạp vào số dư tài khoản trả trước khi tính năng tự động nạp tiền được kích hoạt. |
Không áp dụng | Có |
Di chuyển sang Trang thanh toán được lưu trữ của WorldPay
WorldPay đã cập nhật quy trình xử lý thanh toán an toàn để sử dụng một bộ trang mới, được gọi là Trang thanh toán được lưu trữ.
Nếu đã định cấu hình(các) nhà cung cấp dịch vụ thanh toán WorldPay bằng quy trình xử lý thanh toán an toàn không dùng nữa (trước tháng 8 năm 2017), bạn sẽ cần di chuyển sang Trang thanh toán được lưu trữ mới của WorldPay trước tháng 1 năm 2018.
Cách di chuyển sang Trang thanh toán được lưu trữ của WorldPay:
- Liên hệ với WorldPay để di chuyển tài khoản hiện tại của bạn sang sử dụng Trang thanh toán được lưu trữ mới và nhận mã nhận dạng lượt cài đặt mới cho tài khoản của bạn.
- Định cấu hình nhà cung cấp dịch vụ thanh toán WorldPay mới, như mô tả trong phần Định cấu hình nhà cung cấp dịch vụ thanh toán trong Edge, truyền mã nhận dạng lượt cài đặt trong trường
authType. - Định cấu hình(các) nhà cung cấp dịch vụ thanh toán mới trên cổng thông tin dành cho nhà phát triển, như mô tả trong phần Định cấu hình tính năng kiếm tiền trong Cổng thông tin dành cho nhà phát triển.
- Nếu thiết lập tính năng tự động nạp tiền cho tài khoản trả trước bằng nhà cung cấp dịch vụ thanh toán, bạn cần định cấu hình lại tính năng tự động nạp tiền để sử dụng mã nhận dạng nhà cung cấp mới, như mô tả trong phần Thiết lập tính năng tự động nạp tiền cho số dư tài khoản trả trước bằng API.
Các bước tiếp theo
Bạn có thể đặt hạn mức tín dụng cho từng nhà phát triển trả sau. Tìm hiểu cách thực hiện trong bài viết Quản lý số dư trả sau.