Karti (Visa u Mastercard)
Aċċetta ħlasijiet bil-karti ta' kreditu u debitu
Ħarsa Ġenerali
Aċċetta ħlasijiet bil-karti ta' kreditu u debitu permezz tal-API ta' Cost+ bl-użu tal-metodu ta' ħlas credit-card.
{
"transactions": [
{
"payment_method": "credit-card"
}
]
}Marki ta' Karti Appoġġjati
| Marka | Tip |
|---|---|
| Amex | Kreditu |
| Mastercard | Kreditu / Debitu |
| Maestro | Debitu |
| Visa | Kreditu / Debitu |
| V Pay | Debitu |
Opzjonijiet ta' Konfigurazzjoni
Deskrittur Dinamiku
Uża l-qasam dynamic_descriptor biex tissettja test ta' stqarrija personalizzat li jidher fuq l-istqarrija tal-bank jew tal-karta tal-klijent tiegħek.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"dynamic_descriptor": "My Store Order 123"
}
}
]
}Uża l-Isem tal-Klijent bħala Isem id-Detentur tal-Karta
Issettja use_customer_name_as_cardholder_name għal true biex awtomatikament tuża l-isem tal-klijent mill-ordni bħala l-isem tad-detentur tal-karta.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"use_customer_name_as_cardholder_name": true
}
}
]
}Formola Personalizzata tad-Dħul tal-Karta
Jekk trid tibni l-formola tad-dħul tal-karta tiegħek stess minflok tuża l-paġna ta' ħlas ospitata, segwi dawn l-erba' passi.
Pass 1: Oħloq Ordni b'Setup Token
Oħloq ordni u inkludi setup_token: true fid-payment_method_details tat-tranżazzjoni. Dan jgħid lil-Cost+ biex tiġġenera setup token li tista' tuża biex b'mod sigur tittokenizza d-dettalji tal-karta.
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"
}'Ir-risposta se tinkludi valur ta' setup_token fid-payment_method_details tat-tranżazzjoni:
{
"id": "order-uuid",
"transactions": [
{
"id": "txn-uuid",
"payment_method": "credit-card",
"payment_method_details": {
"setup_token": "st_abc123..."
}
}
]
}Pass 2: Ittokenizza d-Dettalji tal-Karta
Ibgħat il-PAN tal-karta, id-data ta' skadenza, u s-setup token lejn l-endpoint tat-token. Dan jivvawltja l-karta b'mod sigur u jirritorna 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..."
}'Risposta:
{
"vault_token": "vt_xyz789..."
}Pass 3: Awtentika t-Tranżazzjoni
Issottometti l-vault_token u cvc lejn l-endpoint tal-awtentikazzjoni. Jekk 3D Secure huwa meħtieġ, tirċievi redirect_url biex tirridirezzjona l-klijent lejn il-paġna ta' awtentikazzjoni tal-bank tagħhom.
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"
}'Risposta:
{
"redirect_url": "https://3ds.bank.example.com/auth?id=..."
}Irridirezzjona l-klijent lejn redirect_url biex jlesti l-awtentikazzjoni 3D Secure. Wara li l-klijent jlesti (jew jikkanċella) l-awtentikazzjoni, jiġi ridirezzjonat lura lejn ir-return_url tiegħek.
Pass 4: Agħmel Polling tal-Istatus tal-Ordni
Wara li l-klijent jirritorna minn 3D Secure, agħmel polling tal-ordni biex tiċċekkja l-istatus finali.
curl -X GET https://api.costplus.online/v1/orders/{order_id} \
-u your-api-key:L-istatus tal-ordni tinbidel għal waħda minn:
| Status | Tifsira |
|---|---|
completed | Il-ħlas irnexxielu |
cancelled | Il-klijent ikkanċella jew l-awtentikazzjoni falliet |
error | Żball seħħ waqt l-ipproċessar |
expired | L-ordni skadiet qabel ma tlestiiet |
Għal flussi ta' awtorizzazzjoni manwali u capture b'ħlasijiet tal-karti, ara l-gwida Auth / Capture / Void.