Eilutė Kūrėjams
Nuo bandomojo rakto iki pirmo mokėjimo
Keturi žingsniai, kaip prijungti mokėjimą nuoroda su bandomuoju raktu. Visi pavyzdžiai išgalvoti.
- Žingsnis
Gaukite bandomąjį raktą
Bandomoji aplinka atskirta nuo tikros, todėl joje galima pereiti visą srautą be realių pinigų.
Pavyzdinis fragmentas
POST /v1/sandbox/keys Authorization: Bearer sk_test_xxxxxxxx { "label": "test-key" } - Žingsnis
Sukurkite mokėjimo nuorodą
Užklausoje nurodote sumą, valiutą ir trumpą aprašymą. Atsakyme grąžiname nuorodos adresą.
Pavyzdinis fragmentas
POST /v1/payment-links Authorization: Bearer sk_test_xxxxxxxx { "amount": "40.00", "currency": "EUR" } - Žingsnis
Klausykitės pranešimų
Kai mokėjimo būsena pasikeičia, į jūsų adresą išsiunčiame pasirašytą pranešimą.
Pavyzdinis fragmentas
POST /your-endpoint X-Signature: t=0000,v1=xxxx { "type": "payment.succeeded" } - Žingsnis
Pereikite į tikrą aplinką
Pakeičiate raktą ir patikrinate, ar pranešimai pasiekia jūsų adresą. Nuo tos dienos mokėjimai jau realūs.
Pavyzdinis fragmentas
Authorization: Bearer sk_live_xxxxxxxx GET /v1/payments/{id}
Sąsajos taškai trumpai
- POST/v1/payment-linksSukuria mokėjimo nuorodą
- GET/v1/payments/{id}Grąžina mokėjimo būseną
- POST/v1/refundsInicijuoja dalinį grąžinimą
- GET/v1/payoutsIšvardija išmokų ciklus
- POST/v1/transfersSiunčia pervedimą į sąskaitą
Pranešimai
Kai mokėjimo būsena pasikeičia, platforma siunčia pasirašytą pranešimą į jūsų nurodytą adresą. Patikrinkite parašą ir atsakykite greitai, kad pranešimas nebūtų kartojamas.
Idempotencija
Prie kiekvienos kūrimo užklausos pridėkite unikalų raktą, kad pakartotas bandymas nenuskaitytų du kartus. Su tuo pačiu raktu grąžinamas pirmas rezultatas, o ne naujas mokėjimas.
Užsisakykite kortelę šeimai
Parašykite mums, ir komanda atsakys el. paštu bei aptars kortelės išdavimą.