Kartice (Visa in Mastercard)
Sprejemajte plačila s kreditnimi in debetnimi karticami
Pregled
Sprejemajte plačila s kreditnimi in debetnimi karticami prek Cost+ API z uporabo plačilne metode credit-card.
{
"transactions": [
{
"payment_method": "credit-card"
}
]
}Podprte blagovne znamke kartic
| Blagovna znamka | Tip |
|---|---|
| Amex | Kreditna |
| Mastercard | Kreditna / Debetna |
| Maestro | Debetna |
| Visa | Kreditna / Debetna |
| V Pay | Debetna |
Možnosti konfiguracije
Dinamični deskriptor
Uporabite polje dynamic_descriptor za nastavitev besedila po meri, ki se prikaže na bančnem izpisku ali kartičnem izpisku stranke.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"dynamic_descriptor": "My Store Order 123"
}
}
]
}Uporaba imena stranke kot imena imetnika kartice
Nastavite use_customer_name_as_cardholder_name na true za samodejno uporabo imena stranke iz naročila kot imena imetnika kartice.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"use_customer_name_as_cardholder_name": true
}
}
]
}Obrazec za vnos kartice po meri
Če želite zgraditi lasten obrazec za vnos kartice namesto uporabe gostovane plačilne strani, sledite tem štirim korakom.
Korak 1: Ustvarite naročilo z nastavitvenim žetonom
Ustvarite naročilo in vključite setup_token: true v payment_method_details transakcije. To sporoči Cost+, da generira nastavitveni žeton, ki ga lahko uporabite za varno tokenizacijo kartičnih podatkov.
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 bo vključeval vrednost setup_token v 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šljite PAN kartice, datum veljavnosti in nastavitveni žeton na končno točko za žetone. To varno shrani kartico in vrne 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: Avtenticirajte transakcijo
Pošljite vault_token in cvc na končno točko za avtentikacijo. Če je potrebna 3D Secure avtentikacija, boste prejeli redirect_url za preusmeritev stranke na avtentikacijsko stran njene 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=..."
}Preusmerite stranko na redirect_url za dokončanje 3D Secure avtentikacije. Po tem, ko stranka dokonča (ali prekliče) avtentikacijo, bo preusmerjena nazaj na vaš return_url.
Korak 4: Poizvedujte o statusu naročila
Po vrnitvi stranke iz 3D Secure poizvedujte o naročilu za preverjanje končnega statusa.
curl -X GET https://api.costplus.online/v1/orders/{order_id} \
-u your-api-key:Status naročila se bo spremenil v enega od:
| Status | Pomen |
|---|---|
completed | Plačilo je bilo uspešno |
cancelled | Stranka je preklicala ali avtentikacija ni uspela |
error | Med obdelavo je prišlo do napake |
expired | Naročilo je poteklo pred dokončanjem |
Za ročne tokove avtorizacije in zajema s kartičnimi plačili glejte vodnik Avtorizacija / zajem / razveljavitev.