Cártaí (Visa & Mastercard)
Glac le híocaíochtaí cárta creidmheasa agus dochair
Forbhreathnú
Glac le híocaíochtaí cárta creidmheasa agus dochair tríd an API Cost+ ag úsáid an mhodha íocaíochta credit-card.
{
"transactions": [
{
"payment_method": "credit-card"
}
]
}Brandaí Cártaí a dTacaítear Leo
| Branda | Cineál |
|---|---|
| Amex | Creidmheas |
| Mastercard | Creidmheas / Dochar |
| Maestro | Dochar |
| Visa | Creidmheas / Dochar |
| V Pay | Dochar |
Roghanna Cumraíochta
Tuairisceoir Dinimiciúil
Úsáid an réimse dynamic_descriptor chun téacs ráitis saincheaptha a shocrú a fheicfidh do chustaiméir ar a ráiteas bainc nó cárta.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"dynamic_descriptor": "My Store Order 123"
}
}
]
}Ainm an Chustaiméara a Úsáid mar Ainm Sealbhóra Cárta
Socraigh use_customer_name_as_cardholder_name go true chun ainm an chustaiméara ón ordú a úsáid go huathoibríoch mar ainm an tsealbhóra cárta.
{
"transactions": [
{
"payment_method": "credit-card",
"payment_method_details": {
"use_customer_name_as_cardholder_name": true
}
}
]
}Foirm Iontráil Cárta Saincheaptha
Más mian leat d'fhoirm iontráil cárta féin a thógáil in ionad an leathanach íocaíochta óstáilte a úsáid, lean na ceithre chéim seo.
Céim 1: Ordú a Chruthú le Comhartha Socraithe
Cruthaigh ordú agus cuir setup_token: true san áireamh i payment_method_details an idirbhirt. Insíonn sé seo do Cost+ comhartha socraithe a ghiniúint ar féidir leat é a úsáid chun sonraí cárta a chomharthú go slán.
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"
}'Beidh luach setup_token san fhreagra i payment_method_details an idirbhirt:
{
"id": "order-uuid",
"transactions": [
{
"id": "txn-uuid",
"payment_method": "credit-card",
"payment_method_details": {
"setup_token": "st_abc123..."
}
}
]
}Céim 2: Sonraí Cárta a Chomharthú
Seol PAN an chárta, dáta éaga, agus an comhartha socraithe chuig an gcríochphointe comharthaí. Déanann sé seo an cárta a stóráil go slán agus seolann vault_token ar ais.
curl -X POST https://api.costplus.online/v1/tokens/ \
-H "Content-Type: application/json" \
-d '{
"pan": "4111111111111111",
"expiry_date": "1228",
"setup_token": "st_abc123..."
}'Freagra:
{
"vault_token": "vt_xyz789..."
}Céim 3: An Idirbheart a Fhíordheimhniú
Seol an vault_token agus cvc chuig an gcríochphointe fíordheimhnithe. Má tá 3D Secure riachtanach, gheobhaidh tú redirect_url chun an custaiméir a atreorú chuig leathanach fíordheimhnithe a mbainc.
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"
}'Freagra:
{
"redirect_url": "https://3ds.bank.example.com/auth?id=..."
}Atreorófar an custaiméir chuig redirect_url chun fíordheimhniú 3D Secure a chríochnú. Tar éis don chustaiméir é a chríochnú (nó a chealú), atreorófar ar ais iad chuig do return_url.
Céim 4: Stádas an Ordaithe a Phóláil
Tar éis don chustaiméir filleadh ó 3D Secure, pólail an t-ordú chun an stádas deiridh a sheiceáil.
curl -X GET https://api.costplus.online/v1/orders/{order_id} \
-u your-api-key:Aistreoidh status an ordaithe go ceann díobh seo:
| Stádas | Brí |
|---|---|
completed | D'éirigh leis an íocaíocht |
cancelled | Cheal an custaiméir nó theip ar an bhfíordheimhniú |
error | Tharla earráid le linn próiseála |
expired | D'éag an t-ordú sular críochnaíodh é |
Le haghaidh sreafaí údaraithe agus gabhála de láimh le híocaíochtaí cárta, féach ar an treoir Údarú / Gabháil / Neamhniú.