programming

Làm thế nào để có được sạc ID Stripe

Vấn đề của tôi nghe có vẻ giống nhau mặc dù. Tôi đã có thanh toán trong nước. Mỗi ngày, các khoản phí trong ngày được chuyển đến ngân hàng của tôi và tôi cần ứng dụng của mình biết khi nào chúng được thanh toán để có thể chia tiền. Tôi cần biết những khoản phí nào được bao gồm trong chuyển khoản nói trên

Giống như Matt đã đề xuất, lưu trữ cục bộ là một cách hay. Tôi có bảng Tính phí cục bộ, bảng Chuyển cục bộ và bảng StripeEvent cục bộ [ghi nhật ký sự kiện để tôi không xử lý sự kiện hai lần].

Khi khách hàng của tôi thanh toán, tôi nhấn Stripe và đó là lúc tôi tạo bản ghi Khoản phí cục bộ. Dữ liệu đó có ChargeId từ sọc. Sau đó, tôi lắng nghe sự chuyển giao. sự kiện trả tiền. Khi chuyển khoản. đã thanh toán đến, tôi lưu trữ Chuyển khoản cục bộ. Vì vậy, bây giờ tôi có một TransferId.

Sau đó đến các giao dịch số dư. truy xuất các giao dịch số dư, theo loại Khoản phí và lọc chúng để khớp với transferId [tất cả điều này vẫn nằm trong phân tích cú pháp webhook]. Điều này trả về một danh sách tất cả các khoản phí cho lần chuyển đó. Mỗi mục trong danh sách này sẽ khớp với một mục trong bảng phí địa phương của bạn [ít nhất là tốt hơn. ]. sau đó tôi cập nhật Phí để lưu transferId cho mỗi lần sạc.

Gói yêu cầu PHP 5. 4+ và tuân theo tiêu chuẩn FIG PSR-1, PSR-2 và PSR-4 để đảm bảo khả năng tương tác cao giữa mã PHP được chia sẻ và được kiểm tra đơn vị đầy đủ

Đọc qua Hướng dẫn cài đặt

Đặc trưng

phí
- Có thể tạo ra một khoản phí
- Có thể truy xuất một khoản phí
- Có thể cập nhật một khoản phí
- Có thể chụp một khoản phí
- Có thể truy xuất tất cả các khoản phí
hoàn lại tiền
- Có thể tạo khoản hoàn trả
- Có thể lấy lại tiền hoàn lại
- Có thể cập nhật tiền hoàn lại
- Có thể truy xuất tất cả các khoản tiền hoàn lại
khách hàng
- Có thể tạo một khách hàng
- Có thể lấy một khách hàng
- Có thể cập nhật một khách hàng
- Có thể xóa một khách hàng
- Có thể áp dụng chiết khấu cho khách hàng
- Có thể truy xuất tất cả khách hàng
thẻ
- Có thể tạo thẻ
- Có thể lấy thẻ
- Có thể cập nhật thẻ
- Có thể xóa thẻ
- Có thể truy xuất tất cả các thẻ
đăng ký
- Có thể tạo đăng ký
- Có thể truy xuất đăng ký
- Có thể cập nhật đăng ký
- Có thể hủy đăng ký
- Có thể kích hoạt lại đăng ký đã hủy
- Có thể áp dụng giảm giá cho một thuê bao
- Có thể truy xuất tất cả các đăng ký đang hoạt động
Các kế hoạch
- Có thể tạo một kế hoạch
- Có thể truy xuất một kế hoạch
- Có thể cập nhật kế hoạch
- Có thể xóa một kế hoạch
- Có thể truy xuất tất cả các kế hoạch
phiếu giảm giá
- Có thể tạo phiếu giảm giá
- Có thể truy xuất phiếu giảm giá
- Có thể cập nhật phiếu giảm giá
- Có thể xóa phiếu giảm giá
- Có thể truy xuất tất cả các phiếu giảm giá
hóa đơn
- Có thể tạo hóa đơn
- Có thể truy xuất hóa đơn
- Có thể truy xuất một mục hàng hóa đơn
- Có thể truy xuất hóa đơn sắp tới
- Có thể cập nhật hóa đơn
- Có thể thanh toán hóa đơn
- Có thể truy xuất tất cả các hóa đơn
mục hóa đơn
- Có thể tạo một mục hóa đơn
- Có thể truy xuất một mục hóa đơn
- Có thể cập nhật một mục hóa đơn
- Có thể xóa một mục hóa đơn
- Có thể truy xuất tất cả các mục hóa đơn
tranh chấp
- Có thể cập nhật tranh chấp
- Có thể đóng một tranh chấp
chuyển khoản
- Có thể tạo chuyển khoản
- Có thể truy xuất chuyển khoản
- Có thể cập nhật chuyển khoản
- Có thể hủy chuyển khoản
- Có thể truy xuất tất cả các lần chuyển
Người nhận
- Có thể tạo người nhận
- Có thể truy xuất người nhận
- Có thể cập nhật người nhận
- Có thể xóa người nhận
- Có thể truy xuất tất cả người nhận
Phí đăng ký
- Có thể lấy lệ phí nộp đơn
- Có thể truy xuất tất cả các khoản phí ứng dụng
Hoàn phí nộp đơn
- Có thể tạo hoàn phí nộp đơn
- Có thể lấy lại một khoản hoàn trả lệ phí ứng dụng
- Có thể cập nhật hoàn phí nộp đơn
- Có thể truy xuất tất cả các khoản hoàn trả phí đăng ký
Tài khoản
- Có thể truy xuất chi tiết tài khoản
THĂNG BẰNG
- Có thể lấy số dư
- Có thể truy xuất giao dịch số dư
- Có thể truy xuất tất cả lịch sử số dư
Sự kiện
- Có thể truy xuất một sự kiện
- Có thể truy xuất tất cả các sự kiện
mã thông báo
- Có thể tạo mã thông báo thẻ
- Có thể tạo mã thông báo tài khoản ngân hàng
- Có thể truy xuất mã thông báo
Tải lên tệp
- Có thể tạo tệp tải lên
- Có thể truy xuất tệp tải lên
- Có thể truy xuất tất cả các tệp tải lên

ví dụ

Truy xuất tất cả khách hàng

$stripe = Stripe::make['your-stripe-api-key'];

$customers = $stripe->customers[]->all[];

foreach [$customers['data'] as $customer] {
    var_dump[$customer['email']];
}

Truy xuất khách hàng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cài đặt

Các gói Cartalyst sử dụng Composer, để biết thêm thông tin về cách cài đặt Composer, vui lòng đọc Tài liệu về Composer

Sự chuẩn bị

Mở tệp

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

11 của bạn và thêm phần sau vào mảng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

"cartalyst/stripe": "~1.0"

Ghi chú. Đảm bảo rằng sau những thay đổi được yêu cầu, tệp
$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];
11 của bạn hợp lệ bằng cách chạy
$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];
14

Cài đặt các phụ thuộc

Chạy Composer để cài đặt hoặc cập nhật yêu cầu mới

php composer install

hoặc

________số 8

Bây giờ bạn có thể yêu cầu tệp

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

15 để tự động tải gói

khởi tạo

Tạo một phiên bản Stripe mới rất dễ dàng và đơn giản. Vui lòng kiểm tra các ví dụ dưới đây để được giải thích thêm

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Bạn có thể sử dụng các biến môi trường thay vì chuyển chúng dưới dạng đối số, như vậy

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Sau đó, khi khởi tạo, Stripe sẽ tự động phát hiện những thứ này và sử dụng cho phù hợp

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

3____14

Ghi chú. Xin lưu ý rằng Stripe API KEY luôn được yêu cầu xác định, thông qua biến môi trường hoặc bằng cách chuyển nó làm đối số đầu tiên

tích hợp

Các gói Cartalyst là khung bất khả tri và do đó có thể được tích hợp dễ dàng nguyên bản hoặc với khung yêu thích của bạn

ấu trùng

Vui lòng tham khảo các liên kết bên dưới để biết hướng dẫn về cách tích hợp gói trong ứng dụng Laravel của bạn

Tích hợp vào Laravel 4 của bạn. 2 ứng dụng
Tích hợp vào Laravel 5 của bạn. 0 ứng dụng
Tích hợp vào Laravel 5 của bạn. 1 ứng dụng
Tích hợp vào Laravel 5 của bạn. 2 ứng dụng

Cách sử dụng

phí

Để tính phí thẻ tín dụng hoặc thẻ ghi nợ, bạn tạo một đối tượng tính phí mới. Bạn có thể truy xuất và hoàn trả các khoản phí riêng lẻ cũng như liệt kê tất cả các khoản phí. Các khoản phí được xác định bởi một ID duy nhất

Tạo một khoản phí

Để tính phí thẻ tín dụng, bạn cần tạo một đối tượng tính phí mới. Nếu khóa API của bạn ở chế độ thử nghiệm, thẻ được cung cấp sẽ không thực sự bị tính phí, mặc dù mọi thứ khác sẽ diễn ra như thể ở chế độ trực tiếp. [Stripe sẽ cho rằng khoản phí đã hoàn tất thành công]

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionamounttruenumbernullSố tiền dương thể hiện số tiền cần nạp thẻ. currencytruestringnull Mã ISO 3 chữ cái cho tiền tệ. customerfalsestringnullSố nhận dạng duy nhất của khách hàng. nguồntruestring. arraynullNguồn có thể là mã thông báo hoặc từ điển chứa thông tin chi tiết về nguồn. descriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào một đối tượng điện tích. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng tính phí. capturefalseboolnullCó hay không thu phí ngay lập tức. statement_descriptionfalsestringnullMột chuỗi tùy ý được hiển thị cùng với tên công ty của bạn trên bảng sao kê thẻ tín dụng của khách hàng. biên nhận_emailfalsestringnullĐịa chỉ email để gửi biên lai của khoản phí này tới. application_feeffalseintegernullPhí nộp đơn để thêm vào khoản phí này. shippingfalsearray[]Thông tin giao hàng cho khoản phí. Giúp ngăn chặn gian lận về phí đối với hàng hóa vật chấtCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất một khoản phí

Truy xuất các chi tiết của một khoản phí đã được tạo trước đó. Cung cấp ID khoản phí duy nhất đã được trả lại từ yêu cầu trước đó và Stripe sẽ trả lại thông tin khoản phí tương ứng. Thông tin tương tự được trả về khi tạo hoặc hoàn phí

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phíCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật một khoản phí

Cập nhật khoản phí đã chỉ định bằng cách đặt giá trị của các tham số được truyền. Mọi tham số không được cung cấp sẽ được giữ nguyên

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phí. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptiondescriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào một đối tượng phí. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng tính phí. cheat_detailsfalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng tính phí để cung cấp thông tin về mức độ rủi ro của đối tượng đóCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Chụp một khoản phí

Ghi lại khoản thanh toán của một khoản phí hiện tại, chưa được ghi lại. Đây là nửa sau của quy trình thanh toán hai bước, trong đó đầu tiên bạn tạo khoản phí với tùy chọn thu hồi được đặt thành false

Các khoản thanh toán chưa được thu hồi sẽ hết hạn đúng bảy ngày sau khi chúng được tạo. Nếu chúng không được chụp vào thời điểm đó, chúng sẽ được đánh dấu là đã hoàn tiền và sẽ không thể chụp được nữa

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phí. $parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionamountfalsenumbernullSố tiền dương cho giao dịch. application_feeffalsestringnullMột khoản phí nộp đơn để thêm vào khoản phí này. Chỉ có thể được sử dụng với Stripe Connect. biên nhận_emailfalsestringnullĐịa chỉ email để gửi biên lai của khoản phí này tớiCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả các khoản phí

Trả về danh sách các khoản phí bạn đã tạo trước đó. Các khoản phí được trả lại theo thứ tự được sắp xếp, với các khoản phí gần đây nhất xuất hiện đầu tiên

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncreatedfalsestringnullMột bộ lọc trong danh sách dựa trên trường đã tạo đối tượng. customerfalsestringnullSố nhận dạng duy nhất của khách hàng. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

hoàn lại tiền

Đối tượng hoàn tiền cho phép bạn hoàn lại khoản phí đã được tạo trước đó nhưng chưa được hoàn lại. Tiền sẽ được hoàn trả vào thẻ tín dụng hoặc thẻ ghi nợ đã được tính phí ban đầu. Các khoản phí bạn đã tính ban đầu cũng được hoàn trả

Tạo tiền hoàn lại

Tạo khoản hoàn trả mới sẽ hoàn trả khoản phí đã được tạo trước đó nhưng chưa được hoàn trả. Tiền sẽ được hoàn trả vào thẻ tín dụng hoặc thẻ ghi nợ đã được tính phí ban đầu. Các khoản phí bạn đã tính ban đầu cũng được hoàn trả

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phí. $amounttruenumbernullSố tiền dương thể hiện số tiền của khoản phí này sẽ được hoàn lại. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionrefund_application_feeffalsebooleanfalseBoolean cho biết liệu phí đăng ký có được hoàn lại hay không khi hoàn lại khoản hoàn trả này. reasonfalsestringnullString cho biết lý do hoàn tiền. Nếu được đặt, các giá trị có thể là `trùng lặp`, `gian lận` và `requested_by_customer`. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng hoàn lại tiềnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tiền hoàn lại

Theo mặc định, bạn có thể xem trực tiếp 10 khoản tiền hoàn lại gần đây nhất được lưu trữ trên một khoản phí trên đối tượng tính phí, nhưng bạn cũng có thể truy xuất thông tin chi tiết về một khoản tiền hoàn lại cụ thể được lưu trữ trên khoản phí đó

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phí. $refundIdtruestringnullSố nhận dạng duy nhất của tiền hoàn trảCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật tiền hoàn lại

Cập nhật khoản tiền hoàn lại đã chỉ định bằng cách đặt giá trị của các tham số được chuyển. Mọi tham số không được cung cấp sẽ được giữ nguyên

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phí. $refundIdtruestringnullSố nhận dạng duy nhất hoàn tiền. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionmetadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng hoàn lại tiềnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả các khoản tiền hoàn lại

Bạn có thể xem danh sách các khoản tiền hoàn lại thuộc về một khoản phí cụ thể

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phí. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

khách hàng

Đối tượng khách hàng cho phép bạn thực hiện tính phí định kỳ và theo dõi nhiều khoản phí được liên kết với cùng một khách hàng. API cho phép bạn tạo, xóa và cập nhật khách hàng của mình. Bạn có thể truy xuất từng khách hàng cũng như danh sách tất cả khách hàng của mình

Tạo một khách hàng

Tạo một đối tượng khách hàng mới

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionaccount_balancefalsenumbernullSố tiền dương là số dư tài khoản ban đầu cho khách hàng của bạn. couponfalsestringnullSố nhận dạng phiếu giảm giá áp dụng giảm giá cho tất cả các khoản phí định kỳ. descriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào đối tượng khách hàng. emailfalsestringnullĐịa chỉ email của khách hàng. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng khách hàng. planfalsestringnullPlan cho khách hàng. lượngfalseintegernullSố lượng bạn muốn áp dụng cho đăng ký bạn đang tạo. trial_endfalseintegernullUTC dấu thời gian số nguyên thể hiện thời điểm kết thúc thời gian dùng thử mà khách hàng sẽ nhận được trước khi bị tính phí lần đầu tiên. nguồntruestring. arraynullNguồn có thể là mã thông báo hoặc từ điển chứa thông tin chi tiết về nguồnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Lấy một khách hàng

Truy xuất thông tin chi tiết của một khách hàng hiện tại

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàngCách sử dụng

"cartalyst/stripe": "~1.0"

Cập nhật một khách hàng

Cập nhật khách hàng đã chỉ định bằng cách đặt giá trị của các tham số được truyền

Yêu cầu này chấp nhận hầu hết các đối số giống như lệnh gọi tạo khách hàng

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionaccount_balancefalsenumbernullSố tiền dương là số dư tài khoản ban đầu cho khách hàng của bạn. couponfalsestringnullSố nhận dạng phiếu giảm giá áp dụng giảm giá cho tất cả các khoản phí định kỳ. descriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào đối tượng khách hàng. emailfalsestringnullĐịa chỉ email của khách hàng. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng khách hàng. chuỗi mã nguồn. arraynullNguồn có thể là mã thông báo hoặc từ điển chứa thông tin chi tiết về nguồnCách sử dụng

"cartalyst/stripe": "~1.0"

Xóa một khách hàng

Xóa vĩnh viễn một khách hàng. Nó không thể được hoàn tác. Cũng ngay lập tức hủy bỏ mọi đăng ký đang hoạt động trên khách hàng

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàngCách sử dụng

"cartalyst/stripe": "~1.0"

Xóa giảm giá khách hàng

Xóa giảm giá hiện đang áp dụng cho khách hàng

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàngCách sử dụng

"cartalyst/stripe": "~1.0"

Truy xuất tất cả khách hàng

Trả về danh sách khách hàng của bạn. Các khách hàng được trả về được sắp xếp theo ngày tạo, với những khách hàng được tạo gần đây nhất sẽ xuất hiện đầu tiên

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncreatedfalsestringnullMột bộ lọc trong danh sách dựa trên trường đã tạo đối tượng. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

"cartalyst/stripe": "~1.0"

thẻ

Bạn có thể lưu trữ nhiều thẻ trên một khách hàng để tính phí cho khách hàng sau. Bạn cũng có thể lưu trữ nhiều thẻ ghi nợ trên một người nhận để chuyển sang các thẻ đó sau

Tạo thẻ

Khi bạn tạo một thẻ tín dụng mới, bạn phải chỉ định một khách hàng để tạo nó trên

Tạo thẻ tín dụng mới sẽ không thay đổi thẻ tín dụng mặc định hiện tại của chủ sở hữu thẻ. Nếu chủ sở hữu thẻ không có thẻ tín dụng mặc định, thẻ tín dụng đã thêm sẽ trở thành thẻ mặc định

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $parameterstruestring. mảngnullThẻ có thể là mã thông báo hoặc từ điển chứa thông tin chi tiết về thẻCách sử dụng

Bạn có 3 cách khác nhau nhưng rất giống nhau để tạo thẻ trên Stripe

thông qua một sọc. mã thông báo js [được khuyến nghị]____45

Ghi chú. Tên của trường
$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];
16 có thể khác trên ứng dụng của bạn

Thông qua mã thông báo Stripe API_______46

Ghi chú. Vui lòng tham khảo tài liệu về Mã thông báo để biết thêm thông tin

Thông qua một mảng

"cartalyst/stripe": "~1.0"

Truy xuất thẻ

Truy xuất thông tin chi tiết của thẻ tín dụng hiện có

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $cardIdtruestringnullSố nhận dạng duy nhất của thẻCách sử dụng

"cartalyst/stripe": "~1.0"

Cập nhật thẻ

Nếu chỉ cần cập nhật một số chi tiết thẻ, chẳng hạn như địa chỉ thanh toán hoặc ngày hết hạn, bạn có thể thực hiện việc này mà không cần phải nhập lại toàn bộ chi tiết thẻ

Khi bạn cập nhật thẻ, Stripe sẽ tự động xác thực thẻ

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $cardIdtruestringnullSố nhận dạng duy nhất của thẻ. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionaddress_cityfalsestringnullThành phố địa chỉ chủ thẻ. address_line1falsestringnullDòng địa chỉ chủ thẻ 1. address_line2falsestringnullĐịa chỉ chủ thẻ dòng 2. address_statefalsestringnullTrạng thái địa chỉ của chủ thẻ. address_zipfalsestringnullMã zip địa chỉ chủ thẻ. exp_monthfalsestringnullTháng hết hạn của thẻ. exp_yearfalsestringnullNăm hết hạn thẻ. namefalsestringnullTên chủ thẻCách sử dụng

"cartalyst/stripe": "~1.0"

Xóa thẻ

Bạn có thể xóa thẻ từ khách hàng

Nếu bạn xóa một thẻ hiện là thẻ mặc định của một khách hàng, thì thẻ được thêm gần đây nhất sẽ được sử dụng làm thẻ mặc định mới

Nếu bạn xóa thẻ còn lại cuối cùng của một khách hàng, thuộc tính default_card trên chủ sở hữu của thẻ sẽ trở thành null

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $cardIdtruestringnullSố nhận dạng duy nhất của thẻCách sử dụng

php composer install

Truy xuất tất cả các thẻ

Bạn có thể xem danh sách các thẻ thuộc về khách hàng

php composer install

đăng ký

Đăng ký cho phép bạn tính phí thẻ của khách hàng trên cơ sở định kỳ. Một thuê bao ràng buộc một khách hàng với một kế hoạch cụ thể

Tạo đăng ký

Tạo một đăng ký mới trên một khách hàng hiện có

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionplantruestringnullSố nhận dạng duy nhất của gói. couponfalsestringnull Mã định danh duy nhất của phiếu giảm giá. trial_endfalseintegernullUTC dấu thời gian số nguyên thể hiện thời điểm kết thúc thời gian dùng thử mà khách hàng sẽ nhận được trước khi bị tính phí lần đầu tiên. chuỗi mã nguồn. arraynullNguồn có thể là mã thông báo hoặc từ điển chứa thông tin chi tiết về nguồn. số lượngfalseinteger1Số lượng bạn muốn áp dụng cho đăng ký bạn đang tạo. application_fee_percentfalsedecimalnullMột số thập phân dương [có nhiều nhất hai chữ số thập phân] từ 1 đến 100. tax_percentfalsedecimalnullMột số thập phân dương [có nhiều nhất hai chữ số thập phân] từ 1 đến 100. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng đăng kýCách sử dụng

php composer install

Truy xuất đăng ký

Truy xuất các chi tiết của đăng ký khách hàng hiện tại

php composer install

Cập nhật đăng ký

Cập nhật đăng ký hiện có trên một khách hàng để khớp với các tham số đã chỉ định. Khi thay đổi kế hoạch hoặc số lượng, chúng tôi sẽ tùy ý chia tỷ lệ giá mà chúng tôi tính vào tháng tới để bù cho bất kỳ thay đổi nào về giá

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $subscriptionIdtruestringnullSố nhận dạng duy nhất của gói đăng ký. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionplanfalsestringnullSố nhận dạng duy nhất của kế hoạch. couponfalsestringnull Mã định danh duy nhất của phiếu giảm giá. proratefalsebooleannull Mã định danh duy nhất của phiếu giảm giá. trial_endfalseintegernullFlag báo cho Stripe biết có chia tỷ lệ các gói chuyển đổi trong một chu kỳ thanh toán hay không. chuỗi mã nguồn. arraynullNguồn có thể là mã thông báo hoặc từ điển chứa thông tin chi tiết về nguồn. số lượngfalseinteger1Số lượng bạn muốn áp dụng cho đăng ký bạn đang tạo. application_fee_percentfalsededecimalnullMột số thập phân dương [có nhiều nhất hai chữ số thập phân] từ 1 đến 100. tax_percentfalsedecimalnullMột số thập phân dương [có nhiều nhất hai chữ số thập phân] từ 1 đến 100. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng đăng kýCách sử dụng

php composer install

Hủy đăng ký

Hủy đăng ký của khách hàng. Nếu bạn đặt đối số

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

17 thành true, thì đăng ký sẽ vẫn hoạt động cho đến cuối khoảng thời gian, tại thời điểm đó, đăng ký sẽ bị hủy và không được gia hạn. Theo mặc định, đăng ký bị chấm dứt ngay lập tức. Trong cả hai trường hợp, khách hàng sẽ không bị tính phí lại cho đăng ký. Tuy nhiên, xin lưu ý rằng mọi mục hóa đơn đang chờ xử lý mà bạn đã tạo sẽ vẫn bị tính phí vào cuối kỳ trừ khi bị xóa theo cách thủ công. Nếu bạn đã đặt đăng ký thành hủy vào cuối kỳ, mọi tỷ lệ đang chờ xử lý cũng sẽ được giữ nguyên và được thu thập vào cuối kỳ, nhưng nếu đăng ký được đặt thành hủy ngay lập tức, tỷ lệ đang chờ xử lý sẽ bị xóa

Theo mặc định, tất cả các hóa đơn chưa thanh toán cho khách hàng sẽ bị đóng khi hủy đăng ký. Chúng tôi làm điều này để ngăn chặn các lần thử lại thanh toán không mong muốn sau khi khách hàng đã hủy đăng ký. However, you can reopen the invoices manually after subscription cancellation to have us proceed with automatic retries, or you could even re-attempt payment yourself on all unpaid invoices before allowing the customer to cancel the subscription at all

php composer install

5Hủy khi hết thời hạn

php composer install

Kích hoạt lại đăng ký

Kích hoạt lại đăng ký của khách hàng

php composer install

Xóa giảm giá đăng ký

Xóa giảm giá hiện đang áp dụng cho một thuê bao

php composer install

Truy xuất tất cả các đăng ký

Bạn có thể xem danh sách các đăng ký đang hoạt động của khách hàng. Lưu ý rằng 10 đăng ký hoạt động gần đây nhất luôn có sẵn theo mặc định trên đối tượng khách hàng. Nếu bạn cần nhiều hơn 10 thông số đó, bạn có thể sử dụng thông số giới hạn và

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

18 để chuyển qua các đăng ký bổ sung

php composer install

Các kế hoạch

Gói đăng ký chứa thông tin về giá cho các sản phẩm và cấp độ tính năng khác nhau trên trang web của bạn. Ví dụ: bạn có thể có gói €10/tháng cho các tính năng cơ bản và gói €20/tháng khác cho các tính năng cao cấp

Tạo một kế hoạch

Bạn có thể tạo kế hoạch dễ dàng thông qua trang quản lý kế hoạch của bảng điều khiển Stripe. Việc tạo kế hoạch cũng có thể truy cập được qua API nếu bạn cần tạo kế hoạch nhanh chóng

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionidtruestringnullSố nhận dạng duy nhất của gói. mounttruenumbernullMột số tiền dương cho giao dịch. currencytruestringnull Mã ISO 3 chữ cái cho tiền tệ. intervaltruestringnullChỉ định tần suất thanh toán. Hoặc tuần, tháng hoặc năm. interval_countfalseinteger1Số khoảng thời gian giữa mỗi lần thanh toán đăng ký. nametruestringnullTên của kế hoạch. trial_period_daysfalsestringnullChỉ định thời gian dùng thử tính bằng [số nguyên] ngày. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng chuyển. statement_descriptionfalsestringnullAn arbitrary string which will be displayed on the customer's bank statementCách sử dụng

php composer update

Lấy một kế hoạch

Truy xuất kế hoạch với ID đã cho

Tranh luậnKeyRequiredTypeDefaultDescription$planIdtruestringnull Mã định danh duy nhất của góiCách sử dụng

php composer update

Cập nhật kế hoạch

Cập nhật tên của một kế hoạch. Các chi tiết kế hoạch khác [giá cả, khoảng thời gian, v.v. ], theo thiết kế, không thể chỉnh sửa

Tranh luậnKeyRequiredTypeDefaultDescription$planIdtruestringnull Mã định danh duy nhất của gói. $parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionnametruestringnullTên của kế hoạch. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng chuyển. statement_descriptionfalsestringnullMột chuỗi tùy ý sẽ được hiển thị trên bảng sao kê ngân hàng của khách hàngCách sử dụng

php composer update

Xóa một kế hoạch

Bạn có thể xóa các kế hoạch thông qua trang quản lý kế hoạch của bảng điều khiển Stripe. Tuy nhiên, việc xóa gói không ảnh hưởng đến bất kỳ người đăng ký hiện tại nào đối với gói; . Bạn cũng có thể xóa các kế hoạch thông qua API

Tranh luậnKeyRequiredTypeDefaultDescription$planIdtruestringnull Mã định danh duy nhất của góiCách sử dụng

php composer update

Truy xuất tất cả các kế hoạch

Trả về một danh sách các kế hoạch của bạn

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

php composer update

phiếu giảm giá

Phiếu giảm giá chứa thông tin về giảm giá theo phần trăm mà bạn có thể muốn áp dụng cho khách hàng. Phiếu giảm giá chỉ áp dụng cho các hóa đơn được tạo cho đăng ký định kỳ và các mục hóa đơn;

Tạo một phiếu giảm giá

Bạn có thể tạo phiếu giảm giá dễ dàng thông qua trang quản lý phiếu giảm giá của bảng điều khiển Stripe. Việc tạo phiếu giảm giá cũng có thể truy cập được qua API nếu bạn cần tạo phiếu giảm giá một cách nhanh chóng

Phiếu giảm giá có

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

19 hoặc

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

20 và

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

21. Nếu bạn đặt

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

20, số tiền đó sẽ được trừ vào tổng phụ của bất kỳ hóa đơn nào. Ví dụ: một hóa đơn có tổng phụ là 10 đô la sẽ có tổng cuối cùng là 0 đô la nếu phiếu giảm giá có số 120 của năm 2000 được áp dụng cho nó và một hóa đơn có tổng phụ là 30 đô la sẽ có tổng cuối cùng là 10 đô la nếu phiếu giảm giá có số 120

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionidfalsestringnull Mã định danh duy nhất của phiếu giảm giá, nếu không được cung cấp, một chuỗi ngẫu nhiên sẽ được tạo. durationtruestringnullChỉ định thời gian giảm giá sẽ có hiệu lực. Có thể là `mãi mãi`, `một lần` hoặc `lặp lại`. mount_offfalsenumbernullSố tiền dương biểu thị số tiền cần trừ khỏi tổng hóa đơn [bắt buộc nếu không thông qua percent_off]. currencytruestringnull Mã ISO 3 chữ cái cho tiền tệ. duration_in_monthsfalseintegernullNếu thời lượng lặp lại, một số nguyên dương chỉ định số tháng giảm giá sẽ có hiệu lực. max_redemptionsfalseintegernullMột số nguyên dương chỉ định số lần phiếu giảm giá có thể được đổi trước khi phiếu giảm giá không còn hiệu lực. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng phiếu giảm giá. phần trăm_offfalseintegernullMột số nguyên dương từ 1 đến 100 thể hiện mức chiết khấu mà phiếu giảm giá sẽ áp dụng [bắt buộc nếu không thông quamount_off]. chuộc_byfalseintegernullDấu thời gian Unix chỉ định lần cuối cùng có thể đổi phiếu giảm giáCách sử dụng

php composer update

Truy xuất phiếu giảm giá

Truy xuất phiếu giảm giá với ID đã cho

Tranh luậnKeyRequiredTypeDefaultDescription$couponIdtruestringnullThe coupon unique identifierCách sử dụng

php composer update

Cập nhật phiếu giảm giá

Cập nhật phiếu giảm giá đã chỉ định bằng cách đặt giá trị của các tham số được truyền. Mọi tham số không được cung cấp sẽ được giữ nguyên

Tranh luậnKeyRequiredTypeDefaultDescription$couponIdtruestringnull Mã định danh duy nhất của phiếu giảm giá. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionmetadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng phiếu giảm giáCách sử dụng

php composer update

Xóa phiếu giảm giá

Bạn có thể xóa phiếu giảm giá qua trang quản lý phiếu giảm giá của bảng điều khiển Stripe. Tuy nhiên, việc xóa phiếu giảm giá không ảnh hưởng đến bất kỳ khách hàng nào đã áp dụng phiếu giảm giá; . Bạn cũng có thể xóa phiếu giảm giá qua API

Tranh luậnKeyRequiredTypeDefaultDescription$couponIdtruestringnullThe coupon unique identifierCách sử dụng

php composer update

Truy xuất tất cả các phiếu giảm giá

Trả về danh sách các phiếu giảm giá của bạn

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncreatedfalsestringnullMột bộ lọc trong danh sách dựa trên trường đã tạo đối tượng. customerfalsestringnullSố nhận dạng duy nhất của khách hàng. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

php composer update

hóa đơn

Hóa đơn là báo cáo về số tiền khách hàng nợ trong một thời hạn thanh toán cụ thể, bao gồm đăng ký, mục hóa đơn và bất kỳ điều chỉnh tỷ lệ tự động nào nếu cần

Tạo hóa đơn

Nếu bạn cần lập hóa đơn cho khách hàng của mình ngoài chu kỳ thanh toán thông thường, bạn có thể tạo hóa đơn chứa tất cả các mục hóa đơn đang chờ xử lý, bao gồm cả tỷ lệ. Chu kỳ thanh toán và đăng ký thông thường của khách hàng sẽ không bị ảnh hưởng

Sau khi bạn tạo hóa đơn, hóa đơn sẽ được nhận và thanh toán tự động, mặc dù bạn có thể chọn thanh toán ngay lập tức

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionapplication_feeffalseintegernullPhí đăng ký để thêm vào hóa đơn này. descriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào đối tượng hóa đơn. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng hóa đơn. statement_descriptorfalsestringnullThông tin bổ sung về khoản phí cho bảng sao kê thẻ tín dụng của khách hàng. subscribefalsestringnullSố nhận dạng duy nhất của gói đăng ký cho hóa đơn. tax_percentfalsedecimalnull Thuế suất phần trăm áp dụng cho hóa đơn, được biểu thị dưới dạng số thập phânCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất hóa đơn

Truy xuất hóa đơn với ID đã cho

Tranh luậnKeyRequiredTypeDefaultDescription$invoiceIdtruestringnullSố nhận dạng duy nhất của hóa đơnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất một mục hàng hóa đơn

Khi truy xuất hóa đơn, bạn sẽ nhận được thuộc tính dòng chứa tổng số mục hàng và số mục đầu tiên trong số đó. Ngoài ra còn có một URL nơi bạn có thể truy xuất danh sách chi tiết đơn hàng đầy đủ [được phân trang]

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất hóa đơn sắp tới

Bất cứ lúc nào, bạn có thể xem trước hóa đơn sắp tới cho khách hàng. Thao tác này sẽ hiển thị cho bạn tất cả các khoản phí đang chờ xử lý, bao gồm phí gia hạn đăng ký, phí mục hóa đơn, v.v. Nó cũng sẽ cho bạn thấy bất kỳ giảm giá nào được áp dụng cho khách hàng

Lưu ý rằng khi bạn đang xem hóa đơn sắp tới, bạn chỉ đang xem bản xem trước -- hóa đơn chưa được tạo. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. Nếu bạn muốn thay đổi số tiền mà khách hàng của bạn sẽ được lập hóa đơn, bạn có thể thêm, xóa hoặc cập nhật các mục hóa đơn đang chờ xử lý hoặc cập nhật chiết khấu của khách hàng

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $subscriptionIdfalsestringnullSố nhận dạng duy nhất của gói đăng kýCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật hóa đơn

Cho đến khi một hóa đơn được thanh toán, nó được đánh dấu là mở [đã đóng=sai]. Nếu bạn muốn ngăn Stripe tự động thanh toán hóa đơn hoặc chỉ đơn giản là muốn đóng hóa đơn vì khách hàng không còn nợ nữa, bạn có thể cập nhật tham số đã đóng

Tranh luậnKeyRequiredTypeDefaultDescription$invoiceIdtruestringnullSố nhận dạng duy nhất của hóa đơn. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionapplication_feeffalseintegernullPhí đăng ký để thêm vào hóa đơn này. closedfalsebooleannullBoolean cho biết hóa đơn đã được đóng hay chưa. Để đóng hóa đơn, hãy chuyển đúng. descriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào đối tượng hóa đơn. tha thứfalsebooleannullBoolean đại diện cho việc hóa đơn có được tha thứ hay không. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng hóa đơn. statement_descriptorfalsestringnullThông tin bổ sung về khoản phí cho bảng sao kê thẻ tín dụng của khách hàng. subscribefalsestringnullSố nhận dạng duy nhất của gói đăng ký cho hóa đơn. tax_percentfalsedecimalnull Thuế suất phần trăm áp dụng cho hóa đơn, được biểu thị dưới dạng số thập phânCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Thanh toán hóa đơn

Stripe automatically creates and then attempts to pay invoices for customers on subscriptions. We'll also retry unpaid invoices according to your retry settings. Tuy nhiên, nếu bạn muốn cố gắng thu tiền thanh toán trên hóa đơn ngoài lịch trình thử lại thông thường hoặc vì một số lý do khác, bạn có thể làm như vậy

Tranh luậnKeyRequiredTypeDefaultDescription$invoiceIdtruestringnullSố nhận dạng duy nhất của hóa đơnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả hóa đơn

Bạn có thể liệt kê tất cả các hóa đơn hoặc liệt kê các hóa đơn cho một khách hàng cụ thể. The invoices are returned sorted by creation date, with the most recently created invoices appearing first

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncustomerfalsestringnullSố nhận dạng duy nhất của khách hàng. datefalsestringnullA filter on the list based on the object date field. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10A limit on the number of objects to be returned. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

mục hóa đơn

Đôi khi bạn muốn thêm một khoản phí hoặc tín dụng cho khách hàng nhưng thực tế chỉ tính phí vào thẻ của khách hàng vào cuối chu kỳ thanh toán thông thường. This is useful for combining several charges to minimize per-transaction fees or having Stripe tabulate your usage-based billing totals

Tạo mục hóa đơn mới

Adds an arbitrary charge or credit to the customer's upcoming invoice

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionamounttruenumbernullSố tiền dương cho giao dịch. currencytruestringnull3-letter ISO code for currency. subscribefalsestringnullSố nhận dạng duy nhất của gói đăng ký để thêm mục hóa đơn này vàomô tảfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào một đối tượng hóa đơn. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng hóa đơnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất một mục hóa đơn

Retrieves the invoice item with the given ID

Tranh luậnKeyRequiredTypeDefaultDescription$invoiceItemIdtruestringnullSố nhận dạng duy nhất của mục hóa đơnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật một mục hóa đơn

Cập nhật số tiền hoặc mô tả của một mục hóa đơn trên hóa đơn sắp tới. Chỉ có thể cập nhật một mục hóa đơn trước khi hóa đơn được đính kèm bị đóng

Tranh luậnKeyRequiredTypeDefaultDescription$invoiceItemIdtruestringnullSố nhận dạng duy nhất của mục hóa đơn. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionamounttruenumbernullA positive amount for the transaction. descriptionfalsestringnullAn arbitrary string which you can attach to a invoice object. metadatafalsearray[]A set of key/value pairs that you can attach to a invoice objectCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Xóa một mục hóa đơn

Xóa một mục hóa đơn khỏi hóa đơn sắp tới. Removing an invoice item is only possible before the invoice it's attached to is closed

Tranh luậnKeyRequiredTypeDefaultDescription$invoiceItemIdtruestringnullSố nhận dạng duy nhất của mục hóa đơnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả các mục hóa đơn

Trả về danh sách các mục hóa đơn của bạn. Các mục hóa đơn được trả về được sắp xếp theo ngày tạo, với các mục hóa đơn được tạo gần đây nhất sẽ xuất hiện đầu tiên

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncreatedfalsestringnullMột bộ lọc trong danh sách dựa trên trường đã tạo đối tượng. customerfalsestringnullSố nhận dạng duy nhất của khách hàng. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

tranh chấp

A dispute occurs when a customer questions your charge with their bank or credit card company. Khi khách hàng tranh chấp về khoản phí của bạn, bạn sẽ có cơ hội trả lời tranh chấp với bằng chứng cho thấy khoản phí đó là hợp pháp

Cập nhật tranh chấp

When you get a dispute, contacting your customer is always the best first step. Nếu cách đó không hiệu quả, bạn có thể gửi bằng chứng để giúp chúng tôi giải quyết tranh chấp có lợi cho bạn. Bạn có thể làm điều này trong bảng điều khiển của mình, nhưng nếu muốn, bạn có thể sử dụng API để gửi bằng chứng theo chương trình

Tùy thuộc vào loại tranh chấp của bạn, các trường bằng chứng khác nhau sẽ giúp bạn có cơ hội thắng tranh chấp cao hơn. Bạn có thể muốn tham khảo hướng dẫn của Stripe về các loại tranh chấp để giúp bạn tìm ra những trường bằng chứng cần cung cấp

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phí. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionevidencefalsestringnullMột bằng chứng mà bạn có thể đính kèm vào một đối tượng tranh chấp. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng tính phíCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Đóng tranh chấp

Đóng tranh chấp để nhận một khoản phí cho thấy rằng bạn không có bất kỳ bằng chứng nào để gửi và về cơ bản là 'bác bỏ' tranh chấp, thừa nhận rằng nó đã bị mất

Trạng thái của tranh chấp sẽ thay đổi từ

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

25 thành

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

26. Đóng một tranh chấp là không thể đảo ngược

Tranh luậnKeyRequiredTypeDefaultDescription$chargeIdtruestringnullSố nhận dạng duy nhất của khoản phíCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

chuyển khoản

Khi Stripe gửi tiền cho bạn hoặc bạn bắt đầu chuyển khoản vào tài khoản ngân hàng hoặc thẻ ghi nợ của người nhận bên thứ ba, một đối tượng chuyển khoản sẽ được tạo. Bạn có thể truy xuất các lần chuyển riêng lẻ cũng như liệt kê tất cả các lần chuyển

Tạo chuyển khoản

Để gửi tiền từ tài khoản Stripe của bạn tới người nhận bên thứ ba hoặc tới tài khoản ngân hàng của chính bạn, bạn tạo một đối tượng chuyển khoản mới. Số dư Stripe của bạn phải có khả năng thanh toán số tiền chuyển, nếu không bạn sẽ gặp lỗi "Không đủ tiền"

Nếu khóa API của bạn ở chế độ thử nghiệm, tiền sẽ không thực sự được gửi, mặc dù mọi thứ khác sẽ diễn ra như thể ở chế độ trực tiếp

Tranh luậnKeyRequiredTypeDefaultDescription$transferIdtruestringnullSố nhận dạng duy nhất chuyển. $parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionamounttruenumbernullA positive amount for the transaction. currencytruestringnull Mã ISO 3 chữ cái cho tiền tệ. người nhậntruestringnullID của người nhận hiện tại, đã được xác minh. descriptionfalsestringnullAn arbitrary string which you can attach to a transfer object. bank_accountfalsestringnullNếu người nhận có cả tài khoản ngân hàng và thẻ được đính kèm, thông số này hoặc thông số `card` phải được cung cấp, nhưng không được cung cấp cả hai. cardfalsestringnullSố nhận dạng duy nhất của thẻ. statement_descriptorfalsestringnullMột chuỗi tùy ý sẽ được hiển thị trên bảng sao kê ngân hàng hoặc thẻ của người nhận. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng chuyểnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất chuyển khoản

Truy xuất các chi tiết của một chuyển khoản hiện có. Cung cấp ID chuyển duy nhất từ yêu cầu tạo chuyển hoặc danh sách chuyển và Stripe sẽ trả về thông tin chuyển tương ứng

Tranh luậnKeyRequiredTypeDefaultDescription$transferIdtruestringnullSố nhận dạng duy nhất chuyểnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật chuyển khoản

Updates the specified transfer by setting the values of the parameters passed. Mọi tham số không được cung cấp sẽ được giữ nguyên

Yêu cầu này chỉ chấp nhận mô tả và siêu dữ liệu làm đối số

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả các lần chuyển

Trả về danh sách các giao dịch chuyển tiền hiện có được gửi tới tài khoản ngân hàng của bên thứ ba hoặc Stripe đã gửi cho bạn. The transfers are returned in sorted order, with the most recently created transfers appearing first

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptioncreatedfalsestringnullMột bộ lọc trong danh sách dựa trên trường đã tạo đối tượng. datefalsestringnullMột bộ lọc trong danh sách dựa trên trường ngày của đối tượng. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. người nhậnfalsestringnullSố nhận dạng duy nhất của người nhận. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trang. statusfalsestringnullChỉ chuyển trả lại có trạng thái nhất định. `đang chờ xử lý`, `đã thanh toán` hoặc `không thành công`Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Đảo ngược chuyển nhượng

Chuyển khoản được tạo trước đó có thể được đảo ngược nếu nó chưa được thanh toán. Tiền sẽ được hoàn trả vào số dư khả dụng của bạn và các khoản phí bạn đã tính ban đầu khi chuyển khoản sẽ được hoàn trả. Bạn không thể đảo ngược chuyển Stripe tự động

Create a reversal

When you create a new reversal, you must specify a transfer to create it on

Creating a new reversal on a transfer that has previously been created but not paid out will return the funds to your available balance and refund the fees you were originally charged on the transfer. You may not reverse automatic Stripe transfers

Khi đảo ngược chuyển khoản sang tài khoản Stripe, bạn có thể tùy chọn đảo ngược một phần chuyển khoản. Bạn có thể làm như vậy bao nhiêu lần tùy thích cho đến khi toàn bộ quá trình chuyển tiền được đảo ngược

Once entirely reversed, a transfer can't be reversed again. Phương thức này sẽ trả về lỗi khi được gọi trên một giao dịch chuyển tiền đã được đảo ngược hoặc khi cố gắng đảo ngược nhiều tiền hơn số tiền còn lại trên một giao dịch chuyển tiền

Tranh luậnKeyRequiredTypeDefaultDescription$transferIdtruestringnullSố nhận dạng duy nhất chuyển. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionamountfalsenumbernullA positive amount for the transaction. refund_application_feefalsebooleanfalseBoolean indicating whether the application fee should be refunded when reversing this reversal. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng đảo ngược. descriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào một đối tượng đảo ngượcCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất đảo ngược

Theo mặc định, bạn có thể xem 10 lần đảo ngược gần đây nhất được lưu trữ trực tiếp trên đối tượng chuyển, nhưng bạn cũng có thể truy xuất thông tin chi tiết về một lần đảo ngược cụ thể được lưu trữ trên quá trình chuyển

Tranh luậnKeyRequiredTypeDefaultDescription$transferIdtruestringnullSố nhận dạng duy nhất chuyển. $transferReversalIdtruestringnullSố nhận dạng duy nhất đảo ngược chuyển giaoCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật đảo chiều

Cập nhật đảo chiều đã chỉ định bằng cách đặt giá trị của các tham số được truyền. Mọi tham số không được cung cấp sẽ được giữ nguyên

This request only accepts metadata and description as arguments

Tranh luậnKeyRequiredTypeDefaultDescription$transferIdtruestringnullThe transfer unique identifier. $transferReversalIdtruestringnullSố nhận dạng duy nhất đảo ngược chuyển giao. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionmetadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng đảo ngược. descriptionfalsestringnullAn arbitrary string which you can attach to a reversal objectCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve all reversals

You can see a list of the reversals belonging to a specific transfer. Note that the 10 most recent reversals are always available by default on the transfer object. If you need more than those 10, you can use this API method and the

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

27 and

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

18 parameters to page through additional reversals

Tranh luậnKeyRequiredTypeDefaultDescription$transferIdtruestringnullThe transfer unique identifier. $parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10A limit on the number of objects to be returned. starting_afterfalsestringnullA cursor to be used in paginationCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Người nhận

With recipient objects, you can transfer money from your Stripe account to a third party bank account or debit card. The API allows you to create, delete, and update your recipients. You can retrieve individual recipients as well as a list of all your recipients

Create a recipient

Creates a new recipient object and verifies both the recipient's identity and, if provided, the recipient's bank account information or debit card

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionnametruestringnullThe recipient's full, legal name. typetruestringnullType of the recipient. either `individual` or `corporation`. tax_idfalsestringnullThe recipient's tax ID, as a string. For type individual, the full SSN; for type corporation, the full EIN. bank_accountfalsestring . arraynullA bank account to attach to the recipient. cardfalsestring . arraynullThe card token or an array. emailfalsestringnullThe recipient's email address. descriptionfalsestringnullAn arbitrary string which you can attach to a recipient object. metadatafalsearray[]A set of key/value pairs that you can attach to a recipient objectCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve a recipient

Retrieves the details of an existing recipient. You need only supply the unique recipient identifier that was returned upon recipient creation

Tranh luậnKeyRequiredTypeDefaultDescription$recipientIdtruestringnullThe recipient unique identifierCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Update a recipient

Cập nhật người nhận được chỉ định bằng cách đặt giá trị của các tham số được truyền. Any parameters not provided will be left unchanged

If you update the name or tax ID, the identity verification will automatically be rerun. If you update the bank account, the bank account validation will automatically be rerun

Tranh luậnKeyRequiredTypeDefaultDescription$recipientIdtruestringnullThe recipient unique identifier. $parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionnamefalsestringnullThe recipient's full, legal name. tax_idfalsestringnullThe recipient's tax ID, as a string. Đối với loại cá nhân, SSN đầy đủ; . bank_accountfalsestring . arraynullA bank account to attach to the recipient. cardfalsestring . arraynullThe card token or an array. default_cartfalsestringnullThe card unique identifier. emailfalsestringnullThe recipient's email address. descriptionfalsestringnullAn arbitrary string which you can attach to a recipient object. metadatafalsearray[]A set of key/value pairs that you can attach to a recipient objectCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Delete a recipient

Permanently deletes a recipient. It cannot be undone

Tranh luậnKeyRequiredTypeDefaultDescription$recipientIdtruestringnullThe recipient unique identifier. $cardIdtruestringnullThe card unique identifierCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve all recipients

Returns a list of your recipients. Người nhận được trả về được sắp xếp theo ngày tạo, với người nhận được tạo gần đây nhất xuất hiện đầu tiên

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncreatedfalsestringnullA filter on the list based on the object created field. ending_beforefalsestringnullA cursor to be used in pagination. limitfalseinteger10A limit on the number of objects to be returned. starting_afterfalsestringnullA cursor to be used in pagination. verifiedfalsebooleannullOnly return recipients that are verified or unverifiedCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Products

Store representations of products you sell in product objects, used in conjunction with SKUs. Products may be physical goods, to be shipped, or digital

Create a product

Creates a new product object

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionidtruestringnullThe products unique identifier. nametruestringnullThe product’s name, meant to be displayable to the customer. activefalsebooleannullOnly return products that are active or inactive [e. g. pass false to list all inactive products]. attributesfalsearray[]A list of up to 5 alphanumeric attributes that each SKU can provide values for [e. g. `[ "màu", "kích thước" ]`]. captionfalsestringnullA short one-line description of the product, meant to be displayable to the customer. descriptionfalsestringnullThe product’s description, meant to be displayable to the customer. imagesfalsearray[]A list of up to 8 URLs of images for this product, meant to be displayable to the customer. metadatafalsearray[]A set of key/value pairs that you can attach to a transfer object. package_dimensionsfalsearray[]Kích thước của sản phẩm này, từ khía cạnh vận chuyển. A SKU associated with this product can override this value by having its own `package_dimensions`. shippablefalsebooleantrueWhether this product is shipped [i. e. physical goods]. Defaults to `true`. urlfalsestringnullMột URL của trang web có thể truy cập công khai cho sản phẩm nàyCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve a product

Retrieves the details of an existing product. Supply the unique product ID from either a product creation request or the product list, and Stripe will return the corresponding product information

Tranh luậnKeyRequiredTypeDefaultDescription$productIdtruestringnullThe product unique identifierCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Updates a product

Updates the specific product by setting the values of the parameters passed. Mọi tham số không được cung cấp sẽ được giữ nguyên

Note that a product's

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

29 are not editable. Instead, you would need to deactivate the existing product and create a new one with the new attribute values

Tranh luậnKeyRequiredTypeDefaultDescription$productIdtruestringnullThe product unique identifier. $parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionactivefalsebooleannullOnly return products that are active or inactive [e. g. pass false to list all inactive products]. captionfalsestringnullA short one-line description of the product, meant to be displayable to the customer. descriptionfalsestringnullThe product’s description, meant to be displayable to the customer. imagesfalsearray[]A list of up to 8 URLs of images for this product, meant to be displayable to the customer. metadatafalsearray[]A set of key/value pairs that you can attach to a transfer object. namefalsestringnullThe product’s name, meant to be displayable to the customer. package_dimensionsfalsearray[]Kích thước của sản phẩm này, từ khía cạnh vận chuyển. A SKU associated with this product can override this value by having its own `package_dimensions`. shippablefalsebooleantrueWhether this product is shipped [i. e. vật chất]. Mặc định là `true`. urlfalsestringnullA URL of a publicly-accessible webpage for this productCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve all products

Returns a list of your products. The products are returned sorted by creation date, with the most recently created products appearing first

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

SKUs

Cửa hàng đại diện cho các đơn vị giữ hàng. SKUs describe specific product variations, taking into account any combination of. attributes, currency, and cost. For example, a product may be a t- shirt, whereas a specific SKU represents the

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

30,

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

31 version of that shirt

Can also be used to manage inventory

Create an SKU

Creates a new product object

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionidfalsestringnullThe identifier for the SKU. Must be unique. If not provided, an identifier will be randomly generated. currencytruestringnull3-letter ISO code for currency. inventorytruearray[]Mô tả khoảng không quảng cáo của SKU. pricetruenumbernullChi phí của mặt hàng dưới dạng số nguyên dương theo đơn vị tiền tệ nhỏ nhất [nghĩa là 100 xu để tính phí $1. 00, or 1 to charge ¥1, Japanese Yen being a 0-decimal currency]. producttruestringnullThe ID of the product this SKU is associated with. activefalsebooleannullOnly return products that are active or inactive [e. g. pass false to list all inactive products]. thuộc tínhfalsearray[]Danh sách tối đa 5 thuộc tính chữ và số mà mỗi SKU có thể cung cấp giá trị cho [e. g. `[ "color", "size" ]`]. imagefalsestringnullThe URL of an image for this SKU, meant to be displayable to the customer. metadatafalsearray[]A set of key/value pairs that you can attach to a transfer object. package_dimensionsfalsearray[]Kích thước của sản phẩm này, từ khía cạnh vận chuyển. A SKU associated with this product can override this value by having its own `package_dimensions`Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất SKU

Retrieves the details of an existing SKU. Supply the unique SKU identifier from either a SKU creation request or from the product, and Stripe will return the corresponding SKU information

Tranh luậnKeyRequiredTypeDefaultDescription$skuIdtruestringnullThe SKU unique identifierCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Updates an SKU

Updates the specific product by setting the values of the parameters passed. Mọi tham số không được cung cấp sẽ được giữ nguyên

Note that a product's

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

29 are not editable. Instead, you would need to deactivate the existing product and create a new one with the new attribute values

Tranh luậnKeyRequiredTypeDefaultDescription$skuIdtruestringnullThe SKU unique identifier. $parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionactivefalsebooleannullOnly return products that are active or inactive [e. g. pass false to list all inactive products]. currencyfalsestringnull3-letter ISO code for currency. imagefalsestringnullThe URL of an image for this SKU, meant to be displayable to the customer. inventoryfalsearray[]Description of the SKU’s inventory. metadatafalsearray[]A set of key/value pairs that you can attach to a transfer object. package_dimensionsfalsearray[]Kích thước của sản phẩm này, từ khía cạnh vận chuyển. SKU được liên kết với sản phẩm này có thể ghi đè giá trị này bằng cách có `package_dimensions` của riêng nó. pricefalsenumbernullThe cost of the item as a positive integer in the smallest currency unit [that is, 100 cents to charge $1. 00, or 1 to charge ¥1, Japanese Yen being a 0-decimal currency]Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve all SKUs

Returns a list of your SKUs. The SKUs are returned sorted by creation date, with the most recently created SKUs appearing first

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionactivefalsebooleannullOnly return SKUs that are active or inactive [e. g. pass `false` to list all inactive products]. attributesfalsearraynullOnly return SKUs that have the specified key/value pairs in this partially constructed dictionary. Can be specified only if `product` is also supplied. For instance, if the associated product has attributes `["color", "size"]`, passing in `attributes[color]=red` returns all the SKUs for this product that have `color` set to `red`. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. idsfalsestringnullOnly return SKUs with the given IDs. in_stockfalsestringnullOnly return SKUs that are either in stock or out of stock [e. g. pass false to list all SKUs that are out of stock]. If no value is provided, all SKUs are returned. limitfalseinteger10A limit on the number of objects to be returned. productfalsestringnullThe ID of the product whose SKUs will be retrieved. starting_afterfalsestringnullA cursor to be used in paginationCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Orders

The purchase of previously defined products by end customers is handled through the creation of order objects. You can create, retrieve, and pay individual orders, as well as list all orders. Đơn đặt hàng được xác định bởi một ID ngẫu nhiên duy nhất

Tạo một đơn đặt hàng

Creates a new order object

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncurrencytruestringnull3-letter ISO code for currency. customerfalsestringnullThe ID of an existing customer that will be charged in this request. emailfalsestringnullĐịa chỉ email của khách hàng đặt hàng. itemsfalsearray[]List of items constituting the order. metadatafalsearray[]A set of key/value pairs that you can attach to a transfer object. shippingfalsearray[]Shipping address for the order. Required if any of the SKUs are for products that have `shippable` set to trueCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve an order

Retrieves the details of an existing order. Supply the unique order ID from either an order creation request or the order list, and Stripe will return the corresponding order information

Tranh luậnKeyRequiredTypeDefaultDescription$orderIdtruestringnullThe order unique identifierCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật một đơn đặt hàng

Updates the specific order by setting the values of the parameters passed. Any parameters not provided will be left unchanged. This request accepts only the

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

33, and

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

34 as arguments

Tranh luậnKeyRequiredTypeDefaultDescription$orderIdtruestringnullThe order unique identifier. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncouponfalsestringnullA coupon code that represents a discount to be applied to this order. Must be one-time duration and in same currency as the order. metadatafalsearray[]A set of key/value pairs that you can attach to a transfer object. selected_shipping_methodfalsestringnullThe shipping method to select for fulfilling this order. If specified, must be one of the `id`s of a shipping method in the `shipping_methods` array. Nếu được chỉ định, sẽ ghi đè phương thức vận chuyển đã chọn hiện tại, cập nhật `items` nếu cần. statusfalsestringnullCurrent order status. One of `created`, `paid`, `canceled`, `fulfilled`, or `returned`Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Pay an order

Pay an order by providing a source to create a payment

Tranh luậnKeyRequiredTypeDefaultDescription$orderIdtruestringnullThe order unique identifier. $parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptioncustomerfalsestringnullID của một khách hàng hiện tại sẽ bị tính phí trong yêu cầu này. sourcefalsestring . arraynullA payment source to be charged, such as a credit card. If you also pass a customer ID, the source must be the ID of a source belonging to the customer. Otherwise, if you do not pass a customer ID, the source you provide must either be a token, like the ones returned by Stripe. js, or a associative array containing a user's credit card details, with the options described below. Although not all information is required, the extra info helps prevent fraud. emailfalsestringnullĐịa chỉ email của khách hàng đặt hàng. If a `customer` is specified, that customer's email address will be used. application_feefalseintegernullAn application fee to add on to this order payment. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào đối tượng chuyểnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve all orders

Trả về một danh sách các đơn đặt hàng của bạn. The orders are returned sorted by creation date, with the most recently created orders appearing first

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullPlease refer to the list below for a valid list of keys that can be passed on this array. $parametersKeyRequiredTypeDefaultDescriptionending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. idsfalsestringnullChỉ trả lại các đơn đặt hàng có ID đã cho. limitfalseinteger10A limit on the number of objects to be returned. starting_afterfalsestringnullA cursor to be used in pagination. statusfalsestringnullOnly return orders that have the given status. One of `created`, `paid`, `fulfilled`, or `refunded`Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Phí đăng ký

Khi bạn thu phí giao dịch ngoài khoản phí được thực hiện cho người dùng của mình [sử dụng Stripe Connect], một đối tượng phí ứng dụng sẽ được tạo trong tài khoản của bạn. You can list, retrieve, and refund application fees

Retrieve an application fee

Tranh luậnKeyRequiredTypeDefaultDescription$applicationFeeIdtruestringnullThe application fee unique identifierCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Retrieve all application fees

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionchargefalsestringnullChỉ trả lại phí đăng ký cho khoản phí được chỉ định bởi ID khoản phí này. createdfalsestringnullMột bộ lọc trong danh sách dựa trên trường được tạo đối tượng. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Hoàn phí nộp đơn

Các đối tượng Hoàn phí đăng ký cho phép bạn hoàn lại phí đăng ký đã được tạo trước đó nhưng chưa được hoàn trả. Tiền sẽ được hoàn trả vào tài khoản Stripe mà khoản phí ban đầu được thu từ

Tạo một khoản hoàn trả lệ phí ứng dụng

Tranh luậnKeyRequiredTypeDefaultDescription$applicationFeeIdtruestringnullSố nhận dạng duy nhất của phí ứng dụng id. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionamountfalsenumbernullSố tiền dương thể hiện số tiền phí này sẽ được hoàn trả. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng tính phíCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất khoản hoàn trả lệ phí nộp đơn

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Cập nhật hoàn phí nộp đơn

Tranh luậnKeyRequiredTypeDefaultDescription$applicationFeeIdtruestringnullSố nhận dạng duy nhất về phí đăng ký. $refundIdtruestringnullSố nhận dạng duy nhất hoàn phí đăng ký. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionmetadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng tính phíCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả các khoản hoàn trả phí đăng ký

Tranh luậnKeyRequiredTypeDefaultDescription$applicationFeeIdtruestringnullSố nhận dạng duy nhất về phí đăng ký. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trangCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Tài khoản

Đây là một đối tượng đại diện cho tài khoản Stripe của bạn. Bạn có thể truy xuất nó để xem các thuộc tính trên tài khoản như địa chỉ e-mail hiện tại của tài khoản hoặc nếu tài khoản được kích hoạt để tính phí trực tiếp

Truy xuất thông tin về tài khoản Stripe của bạn

Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

THĂNG BẰNG

Đây là một đối tượng đại diện cho số dư Stripe của bạn. Bạn có thể truy xuất nó để xem số dư hiện tại trên tài khoản Stripe của mình

Bạn cũng có thể truy xuất danh sách lịch sử số dư, trong đó có danh sách đầy đủ các giao dịch đã từng đóng góp vào số dư [các khoản phí, tiền hoàn lại, chuyển khoản, v.v.]

Lấy số dư tài khoản

Truy xuất số dư tài khoản hiện tại, dựa trên khóa API đã được sử dụng để thực hiện yêu cầu

Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất lịch sử số dư

Truy xuất giao dịch số dư với ID đã cho

Tranh luậnKeyRequiredTypeDefaultDescription$transactionIdtruestringnullSố nhận dạng duy nhất của giao dịchCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả lịch sử số dư

Trả về danh sách các giao dịch đã đóng góp vào số dư tài khoản Stripe [bao gồm các khoản phí, tiền hoàn lại, chuyển khoản, v.v.]. Các giao dịch được trả về theo thứ tự được sắp xếp, với các giao dịch gần đây nhất xuất hiện đầu tiên

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionavailable_onfalsearraynullMột bộ lọc trong danh sách dựa trên trường available_on của đối tượng. createdfalsearraynullMột bộ lọc trong danh sách dựa trên trường được tạo đối tượng. currencyfalsestringnullending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. sourcefalsearraynullMột bộ lọc trong danh sách dựa trên trường nguồn đối tượng. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trang. transferfalsestringnullChỉ dành cho chuyển Stripe tự động, chỉ trả lại các giao dịch đã được chuyển ra trên ID chuyển được chỉ định. typefalsestringnullChỉ trả về các giao dịch của loại đã cho. Một trong. `phí`, `hoàn tiền`, `điều chỉnh`, `phí_đăng ký`, `phí_hoàn_tiền`, `chuyển_đổi` hoặc `thất_bại chuyển_phí`Cách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Sự kiện

Sự kiện là cách chúng tôi cho bạn biết về điều gì đó thú vị vừa xảy ra trong tài khoản của bạn. Khi một sự kiện thú vị xảy ra, chúng tôi tạo một đối tượng sự kiện mới. Ví dụ: khi tính phí thành công, chúng tôi tạo một khoản phí. sự kiện thành công; . sự kiện thanh toán_không thành công. Lưu ý rằng nhiều yêu cầu API có thể tạo ra nhiều sự kiện. Ví dụ: nếu bạn tạo đăng ký mới cho khách hàng, bạn sẽ nhận được cả khách hàng. đăng ký. sự kiện đã tạo và một khoản phí. sự kiện thành công

Truy xuất một sự kiện

Tranh luậnKeyRequiredTypeDefaultDescription$eventIdtruestringnullSố nhận dạng duy nhất của sự kiệnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả các sự kiện

Tranh luậnKeyRequiredTypeDefaultDescription$parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách các khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncreatedfalsestringnullMột bộ lọc trong danh sách dựa trên trường đã tạo đối tượng. object_idfalsestringnull Định danh đối tượng. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trang. typefalsestringnullMột chuỗi chứa tên sự kiện cụ thể hoặc nhóm sự kiện sử dụng * làm ký tự đại diệnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

mã thông báo

Thường thì bạn muốn có thể tính phí thẻ tín dụng hoặc gửi thanh toán vào tài khoản ngân hàng mà không cần phải giữ thông tin thẻ nhạy cảm trên máy chủ của riêng bạn. Vạch sọc. js giúp việc này trở nên dễ dàng trong trình duyệt, nhưng bạn có thể sử dụng kỹ thuật tương tự trong các môi trường khác với API mã thông báo của chúng tôi

Tạo mã thông báo thẻ

Tạo mã thông báo sử dụng một lần bao bọc các chi tiết của thẻ tín dụng. Mã thông báo này có thể được sử dụng thay cho từ điển thẻ tín dụng với bất kỳ phương thức API nào. Những mã thông báo này chỉ có thể được sử dụng một lần. bằng cách tạo đối tượng tính phí mới hoặc đính kèm chúng với khách hàng

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptioncardtruestring. arraynullSố nhận dạng duy nhất của thẻ. customerfalsestringnullMột khách hàng để tạo mã thông báo choCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Tạo mã thông báo tài khoản ngân hàng

Tạo mã thông báo sử dụng một lần bao gồm các chi tiết của tài khoản ngân hàng. Mã thông báo này có thể được sử dụng thay cho từ điển tài khoản ngân hàng với bất kỳ phương thức API nào. Những mã thông báo này chỉ có thể được sử dụng một lần. bằng cách đính kèm chúng với người nhận

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionbank_accounttruestring. arraynullMột tài khoản ngân hàng để đính kèm với người nhậnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất mã thông báo

Truy xuất mã thông báo với ID đã cho

Tranh luậnKeyRequiredTypeDefaultDescription$tokenIdtruestringnullSố nhận dạng duy nhất của mã thông báoCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Người nhận bitcoin

Người nhận Bitcoin bọc một địa chỉ Bitcoin để khách hàng có thể chuyển khoản thanh toán cho bạn. Hướng dẫn này mô tả cách sử dụng người nhận để tạo thanh toán bằng Bitcoin

Tạo một người nhận Bitcoin

Tạo một đối tượng nhận Bitcoin có thể được sử dụng để chấp nhận thanh toán bitcoin từ khách hàng của bạn. Người nhận hiển thị địa chỉ Bitcoin và được tạo bằng tỷ giá hối đoái bitcoin sang USD có giá trị trong 10 phút

Tranh luậnKeyRequiredTypeDefaultDescription$parameterstruearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionamounttruenumbernullSố tiền dương thể hiện số tiền cần nạp thẻ. currencytruestringnull Mã ISO 3 chữ cái cho tiền tệ. descriptionfalsestringnullMột chuỗi tùy ý mà bạn có thể đính kèm vào một đối tượng điện tích. emailfalsestringnullĐịa chỉ email của khách hàng. metadatafalsearray[]Một tập hợp các cặp khóa/giá trị mà bạn có thể đính kèm vào một đối tượng tính phí. refund_mispaymentsfalseboolnullMột cờ cho biết liệu bạn có muốn Stripe tự động xử lý khoản tiền hoàn lại cho bất kỳ [thanh toán sai] nào hay không[https. //vạch sọc. com/docs/guides/bitcoin#mispayments] cho người nhậnCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất người nhận Bitcoin

Truy xuất người nhận Bitcoin với ID đã cho

Tranh luậnKeyRequiredTypeDefaultDescription$receiverIdtruestringnullSố nhận dạng duy nhất của người nhận bitcoinCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

Truy xuất tất cả người nhận Bitcoin

Trả về danh sách người nhận của bạn. Người nhận được trả về được sắp xếp theo ngày tạo, với người nhận được tạo gần đây nhất xuất hiện đầu tiên

Tranh luậnKeyRequiredTypeDefaultDescription$customerIdtruestringnullSố nhận dạng duy nhất của khách hàng. $parametersfalsearraynullVui lòng tham khảo danh sách bên dưới để biết danh sách khóa hợp lệ có thể được chuyển vào mảng này. $parametersKeyRequiredTypeDefaultDescriptionactivefalsebooleannullMột bộ lọc trong danh sách để chỉ truy xuất các bộ thu đang hoạt động. ending_b BeforefalsestringnullMột con trỏ được sử dụng trong phân trang. fillfalsebooleannullMột bộ lọc trong danh sách để chỉ truy xuất các máy thu đã điền. limitfalseinteger10Giới hạn về số lượng đối tượng được trả về. started_afterfalsestringnullMột con trỏ được sử dụng trong phân trang. quỹ bị bắtfalsebooleannullMột bộ lọc trong danh sách để chỉ truy xuất những người nhận có tiền chưa bị thu hồiCách sử dụng

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

ngoại lệ

API Stripe sẽ đưa ra một vài ngoại lệ khi có gì đó không ổn, chẳng hạn như khi thẻ tín dụng có số xấu được gửi, thẻ tín dụng đã hết hạn hoặc ngay cả khi Stripe. bản thân com đã làm sai điều gì đó

Đây là danh sách tất cả các ngoại lệ mà Stripe API đưa ra với một mô tả ngắn gọn

ExceptionDescriptionCartalyst\Stripe\Exception\BadRequestException Ngoại lệ này sẽ bị ném khi dữ liệu được gửi qua yêu cầu không đúng định dạng. Cartalyst\Stripe\Exception\UnauthorizedException Ngoại lệ này sẽ bị ném nếu Khóa API Stripe của bạn không chính xác. Cartalyst\Stripe\Exception\InvalidRequestException Ngoại lệ này sẽ bị ném bất cứ khi nào yêu cầu không thành công vì một số lý do. Cartalyst\Stripe\Exception\NotFoundException Ngoại lệ này sẽ được đưa ra bất cứ khi nào một yêu cầu dẫn đến lỗi 404. Cartalyst\Stripe\Exception\CardErrorException Ngoại lệ này sẽ được đưa ra bất cứ khi nào thẻ tín dụng không hợp lệ. Cartalyst\Stripe\Exception\ServerErrorException Ngoại lệ này sẽ bị ném bất cứ khi nào Stripe làm sai điều gì đó

Cách sử dụng

Dưới đây là một ví dụ về việc sử dụng API để tìm khách hàng, nhưng khách hàng này không tồn tại, vì vậy nó sẽ tạo ra một kết quả

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

$stripe = Stripe::make['your-stripe-api-key'];

$customer = $stripe->customers[]->find['cus_4EBumIjyaKooft'];

echo $customer['email'];

phân trang

Xử lý phân trang trên API rất khó và thay vì xử lý phân trang theo cách thủ công, gói Stripe đi kèm với một trình lặp tài nguyên sẽ tự động xử lý tất cả những điều này cho bạn

Khoản phí từ Stripe là gì?

Nếu bạn thấy một khoản phí từ chúng tôi trên bảng sao kê thẻ tín dụng của mình, thì có thể bạn đã mua thứ gì đó từ một doanh nghiệp sử dụng dịch vụ của chúng tôi và bản thân doanh nghiệp đó không được phản ánh . .

Tôi có thể tính phí khách hàng trên Stripe không?

Bạn có thể tính phí khách hàng của mình bất kỳ lúc nào và với bất kỳ số tiền nào sau khi bạn đã lưu thẻ của khách hàng vào Stripe . Nếu bạn có một số tiêu chí dựa trên hành động nhất định mà bạn muốn kích hoạt một khoản phí, bạn có thể thiết lập logic đó ở mặt sau của mình và chỉ đạo nó tính phí vào thẻ được liên kết với ID khách hàng.

Stripe có tự động sạc không?

Có Stripe tự động tính phí phương thức thanh toán được lưu trữ của khách hàng . Stripe có thể tự động thanh toán hóa đơn nếu khách hàng có phương thức thanh toán trong hồ sơ. Bạn có thể chọn tự động tính phí khách hàng khi tạo hóa đơn hoặc thông qua API.

Có một khoản phí tối thiểu cho Stripe?

Số tiền tối thiểu là $0. 50 US hoặc loại tiền tính phí tương đương . Giá trị số lượng hỗ trợ tối đa tám chữ số [e. g. , giá trị 99999999 cho khoản phí USD là 999.999 USD. 99].