In this flow, you can save a card (0 amount tokenisation) and submit card details to our payment gateway using backend with your Custom payment form. You can also save a card with the first payment.
To receive a callback after the payment you have to set up callback URL in the Merchant portal under E-shop settings.

1. Initiate a one-off payment.
POST – https://igw-demo.every-pay.com/api/v3/payments/oneoff
Authorization – HTTP Basic Auth
Headers Key:
     o Content-Type ; Value – application/json
Body

{
"api_username": "xxxxxxxxx",
"account_name": "EUR3D1",
"amount": 0,
"order_reference": "test_payment1",
"nonce": "nonce12313131321",
"timestamp":"2020-03-11T10:15:04+00:00" ,
"email": "user@example.com",
"customer_ip": "1.2.3.4",
"customer_url":"https://shop.example.com/cart",
"locale":"EN",
"token_agreement": "unscheduled",
"request_token": true,
"mobile_payment": true
}
Your API username, from General settings.

nonce -Should be a unique value for each request.
timestamp – Should be exact time when initiating a request.

 

 

URL where Customer will be redirected after payment.
token_agreement – Fixed or variable amount, fixed or variable frequency.
request_token – To save card details for MIT and CIT.
mobile_payment – used by SDKs to set card details.

2. In response, you will receive a mobile_access_token which you have to use to submit card details.
!NB! You should never store card details on Customers device or your server. After submitting card details, they should be deleted! For further payments, you should use cc_token for MIT or CIT.
3. To submit card details, you can use your Custom payment form.
POST – https://igw-demo.every-pay.com/api/v3/mobile_payments/card_details
Headers Key:
     o Content-Type ; Value – application/json
• Authorization Bearer mobile_access_token from one-off response (example, Bearer aa280c8fbd20c867dcd26df6xxxb5e66b78c7ce9d )

Body

{
"api_username": "xxxxxxxxxx",
"cc_details": {
"cc_number": "520474xxxxxx1002",
"month": "12",
"year": "2025",
"holder_name": "EveryPay",
"cvc": "xxx"
},
"token_consented": true,
"nonce": "wwwdad25ww67555",
"timestamp": "2020-03-19T09:40:13+00:00"
}
Your API username, from General settings.cc_number full card number

 

 

 

token_consented – checkbox in your payment form. nonce -Should be unique value for each request.
timestamp – Should be exact time when initiating a request.

4. After submiting card details if everything is correct you will receive a response:

{ "payment_state": "waiting_for_3ds_response", "processing_errors": null }

5. You should start to monitor payment link <payment_link>.json and open payment_link from one-off response in the browser. Customer will see bank authentification window. When <payment_link>.json state will change to processing_3ds you should close the browser and return back a Customer to your app and wait for our callback.

6.When you receive a callback you should request payment status using payment_reference from a callback
GET https://igw-demo.every-pay.com/api/v3/payments/payment_reference?api_username=7a40xxxb9b13d
Authorization – HTTP Basic Auth
Headers Key:
     o Content-Type ; Value – application/json
Body – empty
7. In payment status request you will receive a token which you can use for payments to MIT (Merchant initiated transactions) or CIT (Customer initiated transactions) endpoints.

rubriigis Integratsiooni dokumendid
Kas artikkel vastas teie küsimusele?