Cost+Docs

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

BrandaCineál
AmexCreidmheas
MastercardCreidmheas / Dochar
MaestroDochar
VisaCreidmheas / Dochar
V PayDochar

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ádasBrí
completedD'éirigh leis an íocaíocht
cancelledCheal an custaiméir nó theip ar an bhfíordheimhniú
errorTharla earráid le linn próiseála
expiredD'é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ú.

On this page