API

Skema URL yang ringkas dan mudah digunakan untuk menyepadukan perniagaan anda dengan Payment for Stripe.

Ubah hala dengan mudah daripada mana-mana apl atau tapak web iOS, terus ke apl Pembayaran untuk mendapatkan bayaran.

Isi caj baharu

Hantar data kepada Pembayaran untuk membuat caj: payment://new?

Tambah amaun, dalam sen: payment://new?amount=2000

Pilih mata wang yang disokong: payment://new?currency=usd

Tambahkan perihalan berkod URL untuk caj: payment://new?description=Cat+Sweater

Buat invois dengan item baris

Sebagai alternatif, buat invois Stripe item baris: payment://cart?

Lulus id harga dan pasangan kuantiti: payment://cart?line_items=price_xxx:3

Atau sampaikan berbilang id dan kuantiti harga: payment://cart?line_items=price_abc:3,price_xyz:2

Selain itu, anda boleh memohon kupon: payment://cart?coupon=kZjFzekm

Menyediakan maklumat pelanggan (pilihan)

Tambahkan nama yang dikodkan URL untuk pelanggan: payment://new?name=John+Doe

Berikan alamat e-mel untuk resit: payment://new?email=john@doe.com

Sediakan URL panggilan balik

Apabila transaksi berjaya, apl Pembayaran akan kembali ke apl anda. payment://new?callback=https://foo.bar.com/hook

Di samping iOS menghantar anda kembali ke tapak web anda secara automatik, kami juga akan mengembalikan beberapa maklumat termasuk: https://foo.bar.com/hook?success=true&
  amount=2000&currency=usd&
  chargeId=pi_xxxxxx

Sekiranya berlaku ralat, anda mungkin menerima mesej yang diformatkan sebagai: https://foo.bar.com/hook?error[message]=Card+declined

https://foo.bar.com/hook?cancelled=true

Gunakan pelanggan sedia ada

Gunakan pelanggan Stripe sedia ada dengan memberikan ID mereka: payment://new?customer_id=cus_xxxxxx

Ini akan membuat pra-pemilihan pelanggan untuk transaksi tersebut, jadi kaedah pembayaran yang disimpan akan tersedia.

Sertakan metadata tersuai

Luluskan metadata tersuai untuk disertakan pada caj Stripe: payment://new?metadata[order_id]=12345

Tambah berbilang medan metadata mengikut keperluan: payment://new?metadata[order_id]=12345&
  metadata[source]=pos

Proses pembayaran secara automatik

Langkau skrin utama dan mulakan pengecasan dengan segera: payment://new?amount=2000&auto=true

Pembayaran akan bermula secara automatik apabila aplikasi dibuka. Jika pembaca kad disambungkan, ia akan meminta pembayaran serta-merta.

Contoh lengkap

Berikut adalah contoh yang menggabungkan semuanya bersama-sama:

payment://new?amount=2000&
  currency=usd&
  customer_id=cus_xxxxxx&
  metadata[order_id]=12345&
  callback=myapp://payment&
  auto=true

Mahukan sesuatu yang lebih daripada API?
Beritahu kami