Sandbox ta' Gateway tal-Pagamenti Simulat
Tgħallem kif iwieġeb API tal-pagamenti: issimula approvazzjonijiet, rifjuti u 3-D Secure b'kards tat-test ippubblikati — kompletament offline.
🔒 Simulatur edukattiv: ma jikkuntattja l-ebda bank, netwerk tal-kards jew fornitur tal-pagamenti. Jiġu aċċettati biss numri tal-kards tat-test ippubblikati.
Numri tal-kards tat-test ippubblikati
| Numru tal-karta | Netwerk | Riżultat simulat | |
|---|---|---|---|
| 4242 4242 4242 4242 | Visa | Il-pagament jirnexxi | |
| 4000 0000 0000 0002 | Visa | Irrifjutat: generic_decline | |
| 4000 0000 0000 9995 | Visa | Irrifjutat: insufficient_funds | |
| 4000 0000 0000 0069 | Visa | Irrifjutat: expired_card | |
| 4000 0000 0000 0127 | Visa | Irrifjutat: incorrect_cvc | |
| 4000 0000 0000 0119 | Visa | Żball: processing_error | |
| 4000 0025 0000 3155 | Visa | Jeħtieġ awtentikazzjoni 3-D Secure | |
| 5555 5555 5555 4444 | Mastercard | Il-pagament jirnexxi | |
| 3782 822463 10005 | American Express | Il-pagament jirnexxi |
Kif jaħdem il-fluss tal-pagament
Is-server tiegħek joħloq u jikkonferma payment intent, il-gateway iwieġeb bi status, u aktar tard webhook jgħid lill-backend tiegħek ir-riżultat finali. Wettaq l-ordnijiet abbażi tal-webhook, mhux tar-redirect tal-browser.
{
"method": "POST",
"path": "/v1/payment_intents",
"body": {
"amount": 2000,
"currency": "usd",
"confirm": true,
"payment_method_data": {
"type": "card",
"card": {
"number": "4242424242424242",
"exp_month": 12,
"exp_year": 2030,
"cvc": "123"
}
}
}
}{
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"object": "payment_intent",
"livemode": false,
"amount": 2000,
"currency": "usd",
"status": "succeeded",
"payment_method": {
"type": "card",
"card": {
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2030
}
},
"latest_charge": {
"id": "ch_test_8h2j4k6l1m3n5p7q9r0s2t4u",
"authorization_code": "T4K2Q9",
"outcome": {
"network_status": "approved_by_network",
"type": "authorized"
}
}
}{
"id": "evt_test_1a2b3c4d5e6f7g8h9i0j1k2l",
"object": "event",
"type": "payment_intent.succeeded",
"livemode": false,
"data": {
"object": {
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"status": "succeeded",
"amount": 2000,
"currency": "usd"
}
}
}{
"id": "evt_test_9z8y7x6w5v4u3t2s1r0q9p8o",
"object": "event",
"type": "payment_intent.payment_failed",
"livemode": false,
"data": {
"object": {
"id": "pi_test_7f6e5d4c3b2a1z0y9x8w7v6u",
"status": "requires_payment_method",
"last_payment_error": {
"type": "card_error",
"code": "card_declined",
"decline_code": "insufficient_funds",
"message": "Your card has insufficient funds."
}
}
}
}Dwar Sandbox ta' Gateway tal-Pagamenti Simulat
Dan is-sandbox ta' gateway tal-pagamenti simulat iħalli lill-iżviluppaturi jitgħallmu kif iwieġeb API tal-pagamenti bil-karta mingħajr ma jmissu flus reali. Agħżel wieħed min-numri tal-kards tat-test ippubblikati, daħħal kwalunkwe data ta' skadenza fil-futur, CVC u ammont, u agħfas Issimula l-pagament. Il-paġna tirritorna oġġett JSON iffurmat bħal payment intent tipiku: id, status, in-netwerk tal-karta u l-aħħar erba' ċifri, kodiċi u messaġġ tar-rifjut għall-fallimenti, u kodiċi ta' awtorizzazzjoni falz għall-approvazzjonijiet. Il-karta 3-D Secure turi sfida simulata biex tkun tista' tipprattika l-immaniġġjar tal-istatus requires_action, u kull riżultat jinkludi l-avveniment tal-webhook korrispondenti. Is-simulatur jaħdem kompletament fil-browser tiegħek: ma jikkuntattja l-ebda bank, netwerk tal-kards jew fornitur tal-pagamenti, u jaċċetta biss in-numri tat-test ippubblikati elenkati fit-tabella. In-numri tal-kards reali jiġu rrifjutati lokalment u qatt ma jintbagħtu x'imkien.
FAQ
Is-sandbox jiċċarġja karta jew jikkuntattja bank?
Le. Kollox huwa simulat fil-browser tiegħek. L-ebda talba ma tintbagħat lil Visatk, lil bank, lil netwerk tal-kards jew lil fornitur tal-pagamenti, u l-ebda flus ma jiċċaqilqu.
Għaliex in-numru tal-karta tiegħi jiġi rrifjutat?
Is-sandbox jaċċetta biss in-numri tat-test ippubblikati fit-tabella. Kwalunkwe numru ieħor, inkluża karta reali, jiġi rrifjutat lokalment biex qatt ma jiġi ttrattat bħala approvat.
Nista' nuża dawn in-numri mal-fornitur tal-pagamenti reali tiegħi?
Dawn huma n-numri tat-test ippubblikati b'mod wiesa' użati fil-modi tat-test tal-fornituri. Jaħdmu biss b'ċwievet API tat-test fis-sandbox tal-fornitur tiegħek; fil-mod live dejjem jiġu rrifjutati.