Karty (Visa a Mastercard)
Prijimajte platby kreditnymi a debitnymi kartami
Prehlad
Prijimajte platby kreditnymi a debitnymi kartami cez Cost+ API pomocou platobnej metody credit-card.
{
"transactions": [
{
"payment_method": "credit-card"
}
]
}Podporovane znacky kariet
| Znacka | Typ |
|---|---|
| Amex | Kreditna |
| Mastercard | Kreditna / Debetna |
| Maestro | Debetna |
| Visa | Kreditna / Debetna |
| V Pay | Debetna |
Moznosti konfiguracii
Dynamicky deskriptor
Pouzite pole dynamic_descriptor na nastavenie vlastneho textu, ktory sa zobrazi na bankovom vypise zakaznika.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"dynamic_descriptor": "My Store Order 123"
}
}
]
}Pouzitie mena zakaznika ako meno drzitela karty
Nastavte use_customer_name_as_cardholder_name na true pre automaticke pouzitie mena zakaznika z objednavky ako meno drzitela karty.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"use_customer_name_as_cardholder_name": true
}
}
]
}Vlastny formular na zadanie karty
Ak chcete vytvorit vlastny formular na zadanie karty namiesto pouzitia hostovanej platobnej stranky, postupujte podla tychto styroch krokov.
Krok 1: Vytvorenie objednavky s nastavovacim tokenom
Vytvorte objednavku a zahrnte setup_token: true v payment_method_details transakcie. To povie Cost+, aby vygenerovalo nastavovaci token, ktory mozete pouzit na bezpecnu tokenizaciu udajov karty.
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"
}'Odpoved bude obsahovat hodnotu setup_token v payment_method_details transakcie:
{
"id": "order-uuid",
"transactions": [
{
"id": "txn-uuid",
"payment_method": "credit-card",
"payment_method_details": {
"setup_token": "st_abc123..."
}
}
]
}Krok 2: Tokenizacia udajov karty
Posliete PAN karty, datum exspiracie a nastavovaci token na endpoint tokenov. Toto bezpecne ulozi kartu a vrati 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..."
}'Odpoved:
{
"vault_token": "vt_xyz789..."
}Krok 3: Autentifikacia transakcie
Odosliete vault_token a cvc na endpoint autentifikacie. Ak je vyzadovany 3D Secure, dostavate redirect_url na presmerovanie zakaznika na autentifikacnu stranku jeho banky.
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"
}'Odpoved:
{
"redirect_url": "https://3ds.bank.example.com/auth?id=..."
}Presmerujte zakaznika na redirect_url na dokoncenie 3D Secure autentifikacie. Po dokonceni (alebo zruseni) autentifikacie bude zakaznik presmerovany spat na vasu return_url.
Krok 4: Dotazovanie na stav objednavky
Po navrate zakaznika z 3D Secure sa dotazujte na objednavku, aby ste skontrolovali konecny stav.
curl -X GET https://api.costplus.online/v1/orders/{order_id} \
-u your-api-key:Stav objednavky status prejde do jedneho z:
| Stav | Vyznam |
|---|---|
completed | Platba bola uspesna |
cancelled | Zakaznik zrusil alebo autentifikacia zlyhala |
error | Pocas spracovania nastala chyba |
expired | Objednavka vyprsala pred dokoncenim |
Pre manualne autorizacne a zachytavacie procesy s kartovymi platbami pozrite navod Autorizacia / Zachytenie / Zrusenie.