Kartice (Visa & Mastercard)
Prihvaćajte plaćanja kreditnim i debitnim karticama
Pregled
Prihvaćajte plaćanja kreditnim i debitnim karticama putem Cost+ API-ja koristeći credit-card način plaćanja.
{
"transactions": [
{
"payment_method": "credit-card"
}
]
}Podržani brendovi kartica
| Brend | Tip |
|---|---|
| Amex | Kreditna |
| Mastercard | Kreditna / Debitna |
| Maestro | Debitna |
| Visa | Kreditna / Debitna |
| V Pay | Debitna |
Opcije konfiguracije
Dinamički deskriptor
Koristite polje dynamic_descriptor za postavljanje prilagođenog teksta izvoda koji se pojavljuje na bankovnom ili kartičnom izvodu vašeg kupca.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"dynamic_descriptor": "My Store Order 123"
}
}
]
}Korištenje imena kupca kao imena vlasnika kartice
Postavite use_customer_name_as_cardholder_name na true za automatsko korištenje imena kupca iz narudžbe kao imena vlasnika kartice.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"use_customer_name_as_cardholder_name": true
}
}
]
}Prilagođeni obrazac za unos kartice
Ako želite izgraditi vlastiti obrazac za unos kartice umjesto korištenja hosted stranice za plaćanje, slijedite ova četiri koraka.
Korak 1: Stvorite narudžbu s setup tokenom
Stvorite narudžbu i uključite setup_token: true u payment_method_details transakcije. Ovo govori Cost+ da generira setup token koji možete koristiti za sigurnu tokenizaciju podataka kartice.
curl -X POST https://api.costplus.online/v1/orders \
-u your-api-key: \
-H "Content-Type: application/json" \
-d '{
"currency": "EUR",
"amount": 5000,
"merchant_order_id": "order-001",
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"setup_token": true
}
}
],
"return_url": "https://example.com/return",
"webhook_url": "https://example.com/webhook"
}'Odgovor će sadržavati vrijednost setup_token u payment_method_details transakcije:
{
"id": "order-uuid",
"transactions": [
{
"id": "txn-uuid",
"payment_method": "credit-card",
"payment_method_details": {
"setup_token": "st_abc123..."
}
}
]
}Korak 2: Tokenizirajte podatke kartice
Pošaljite PAN kartice, datum isteka i setup token na krajnju točku za tokenizaciju. Ovo sigurno pohranjuje karticu i vraća vault_token.
curl -X POST https://api.costplus.online/v1/tokens/ \
-H "Content-Type: application/json" \
-d '{
"pan": "4111111111111111",
"expiry_date": "1228",
"setup_token": "st_abc123..."
}'Odgovor:
{
"vault_token": "vt_xyz789..."
}Korak 3: Autentificirajte transakciju
Pošaljite vault_token i cvc na krajnju točku za autentifikaciju. Ako je potreban 3D Secure, primit ćete redirect_url za preusmjeravanje kupca na stranicu za autentifikaciju njegove banke.
curl -X POST https://api.costplus.online/v1/orders/{order_id}/transactions/{transaction_id}/authenticate/ \
-u your-api-key: \
-H "Content-Type: application/json" \
-d '{
"vault_token": "vt_xyz789...",
"cvc": "123"
}'Odgovor:
{
"redirect_url": "https://3ds.bank.example.com/auth?id=..."
}Preusmjerite kupca na redirect_url za dovršetak 3D Secure autentifikacije. Nakon što kupac dovrši (ili odustane od) autentifikacije, bit će preusmjeren natrag na vaš return_url.
Korak 4: Provjerite status narudžbe
Nakon što se kupac vrati s 3D Secure, provjerite narudžbu kako biste vidjeli konačni status.
curl -X GET https://api.costplus.online/v1/orders/{order_id} \
-u your-api-key:Status narudžbe prijeći će u jedan od:
| Status | Značenje |
|---|---|
completed | Plaćanje je uspjelo |
cancelled | Kupac je odustao ili autentifikacija nije uspjela |
error | Došlo je do greške tijekom obrade |
expired | Narudžba je istekla prije dovršetka |
Za tijekove ručne autorizacije i naplate s kartičnim plaćanjima, pogledajte vodič Autorizacija / Naplata / Poništenje.