Стартирайте Payment for Stripe от вашето приложение (URL схеми)

Кратък отговор: Вашето приложение или уебсайт отваря URL адрес payment://, Payment for Stripe приема плащането, след което отваря URL адреса ви за обратно извикване с резултата. Няма SDK. Няма работа със сървъра. Работи по същия начин на iPhone и Android, с няколко разлики, посочени по-долу.

Пълният справочен файл е достъпен на paymentforstripe.com/api.

Как работи

1. Приложението ви отваря URL адрес с параметри payment://.
2. Payment for Stripe отваря и настройва продажбата. Търговецът приема плащането с четец, Tap to Pay или въведена карта.
3. Когато това е готово, приложението отваря URL адреса ви callback с добавения резултат като параметри на заявката.

Търговецът трябва да е влязъл в профила си. Ако линк пристигне, докато се извършва друго плащане, приложението го отхвърля и обратното ви извикване получава error=charge_in_progress.

Създаване на такса: плащане://ново

Еднократно плащане за определена от вас сума.

 payment://new?amount=2500&currency=eur&description=Coffee%20and%20pastry

 payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-complete

Връзка с липсваща, нулева или нечислова amount се игнорира.

Създайте фактура от вашия каталог: плащане://кошница

Запълва количката с цени от вашия продуктов каталог Stripe. След това търговецът таксува както обикновено и продажбата се запазва в Stripe като платена фактура с тези артикули. Не изпраща фактура по имейл на вашия клиент.

 payment://cart?prices=price_coffee:2,price_muffin:1&email=customer@example.com

Не изпращайте amount с prices. Общата сума се получава от цените, а връзката и с двете се игнорира. Цените, скрити с payment_hidden, все още работят тук.

Плащане на съществуваща фактура: плащане://фактура

Събира лично плащане за отворена фактура Stripe. Сумата, валутата, клиентът и данъкът са от фактурата. При успех приложението маркира фактурата като платена. Работи на iPhone и Android.

 payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paid

Фактурата определя продажбата, така че за всеки от amount, currency, customer, customer_id, email, name, description, coupon, prices или line_items връзката се отхвърля с error=invoice_invalid_param. Фактури, които са платени, невалидни, несъбираеми, $0, обвързани с абонамент или настроени да таксуват метод на плащане по подразбиране, също се отхвърлят, всяка със собствена грешка invoice_….

Обратното повикване

Приложението добавя тези данни към URL адреса ви за обратно извикване:

 myapp://payment-complete?status=success&charge_id=ch_3Qx…&success=true&amount=3500&currency=usd&chargeId=ch_3Qx…

Нуждаете се от един и същ идентификатор и на двете платформи? Първо прочетете stripe_charge_id, след което се върнете към charge_id.

За по-стари интеграции, приложението изпраща също success=true, chargeId, cancelled=true и error[message]. Новият код трябва да чете status.

Отмяната отваря обратното извикване веднага. Успешно или грешно плащане изчаква търговецът да затвори екрана с резултатите, освен ако не подадете auto_return=true. На iPhone продажбата в брой никога не отваря обратното извикване, тъй като нищо не е било таксувано.

Кодиране на URL адреси

• Кодирайте всяка стойност, която съдържа интервали или символи. Интервалите стават %20, { и } стават %7B и %7D, " става %22, : става %3A.
• Ако вашият URL адрес за обратно извикване има собствен низ за заявка, кодирайте цялото обратно извикване, така че & да не разделя връзката ви payment://.
• Запетаите и двоеточията в prices могат да останат такива, каквито са.

Метаданните {"order_id":"1234","location":"Store A"} стават:

 payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7D

По-старият формуляр metadata[order_id]=1234 също работи.