Independent Pages
This document covers all services for independent pages, including the requests and responses associated with these services.
Authenticated Endpoints
Accessing authenticated endpoints requires users to establish a session through Session Authentication. To do this:
Users must log in using their credentials (e.g., username and password) via a designated authentication endpoint.
Upon successful login, the server will generate and return a session cookie to the client.
This session cookie must be included in subsequent API requests as part of the headers. The session cookie serves as proof of authentication and ensures secure access to protected resources.
POST
Order Note Page
POST
Order Note PageThis page is used to add notes for orders.
Path: https://{commerce_url}/orders/checkout/?page=OrderNotePage
Example Request
In order to add notes to the order, the "notes" field needs to be included in the request. This field should contain the specific note that user want to add to the order.
Example Response
The notes are added to the pre_order
field in the response that is returned after the request is sent.
POST
Gift Box Index Page
POST
Gift Box Index PageThis page is called before the Gift Box Page to check the validity of the settings. After performing the necessary checks, it recommends the Gift Box Page as the next page.
Path: https://{commerce_url}/orders/checkout/?page=GiftBoxIndexPage
Example Request
There is no need to include any data in the request. Simply submit an empty request.
Example Response
In the context list, the next step is returned as the GiftBoxPage.
POST
Gift Box Page
POST
Gift Box PageThe gift box field is added to the preorder, and it specifies whether there are options available to add to the gift box.
Path: https://{commerce_url}/orders/checkout/?page=GiftBoxPage
Example Request
Fields such as note
, gift_video
, and gift_video_notification_sent
are included in the request to determine the specifications of the gift box.
Example Response
The sent fields (note
, gift_video
, gift_video_notification_sent
) are added to the gift_box
field in the pre_order.
POST
Delivery Bags Page
POST
Delivery Bags PageThe delivery bags products are calculated and added to the preorder.
Path: https://{commerce_url}/orders/checkout/?page=DeliveryBagsPage
Example Request
To perform the operation for a specific product, it is necessary to include the product SKU field in the request. This allows for identification of the product for which the operation will be performed.
Example Response
The bags_fee
and bags
information are returned in the pre_order
.
POST
Reward List Page
POST
Reward List PageQueries the available rewards can be used by retrieving the credit card information.
Path: https://{commerce_url}/orders/checkout/?page=RewardListPage
Example Request
To list the rewards, provide the card information (card_number
, card_year
, card_month
, card_cvv
).
Example Response
The reward information that is compatible with the provided card information is returned in the page_context
, and the next page will be the RewardSelectionPage
where points can be selected.
POST
Reward Selection Page
POST
Reward Selection PageWhen a POST request is sent to this page, the card and bank compatible rewards are used.
Path: https://{commerce_url}/orders/checkout/?page=RewardSelectionPage
Example Request
There is no need to include any data in the request. Simply submit an empty request.
Example Response
The reward to be used is selected and added to the selected_rewards
and pre_order
fields.
POST
Coupon Selection Page
POST
Coupon Selection PageThis method is used to add or remove coupons from the pre-order.
Path: https://{commerce_url}/orders/checkout/?page=CouponSelectionPage
Example Request
To add or remove coupons from the pre-order, users need to specify the coupon name and the action to be applied. For example, to add a coupon named "A", user would use the action of adding. Similarly, to remove a coupon named "B", you would use the action of removing.
Example Response
Following the applied process, the list of coupons is added to the pre_order
, and the coupons are checked from this list.
POST
Order Selection Page
POST
Order Selection PageBy adding an extra_field in the order, users can utilize its benefits.
Path: https://{commerce_url}/orders/checkout/?page=OrderSelectionPage
Example Request
The schema and other relevant details (data_type
, key
, etc.) must be sent in the extra_field.
Example Response
The provided information is added to the pre_order
along with the specified extra_field
name.
POST
Campaign List Page
POST
Campaign List PageQueries the campaigns suitable for credit cards.
Path: https://{commerce_url}/orders/checkout/?page=CampaignListPage
Example Request
To list the campaigns that are suitable for a specific credit card, card_number
must be sent in the request.
Example Response
Inside the page_context
, a list of campaigns is returned, and the next page targeted is the CampaignSelectionPage.
POST
Campaign Selection Page
POST
Campaign Selection PageThis page adds the selected campaign to the preorder.
Path: https://{commerce_url}/orders/checkout/?page=CampaignSelectionPage
Example Request
One of the rotating campaigns from the CampaignListPage
should be selected and included in the request.
Example Response
In the response, the campaign that was sent in the request as the selected_campaign
is added to the pre_order
.
POST
Address Clear Page
POST
Address Clear PageClears the address information written on the preorder.
Path: https://{commerce_url}/orders/checkout/?page=AddressClearPage
Example Request
There is no need to include any data in the request. Simply submit an empty request.
Example Response
The address information in the pre_order
is cleared, and the next page directed is the AddressSelectionPage
.
POST
Checkout Provider Index Page
POST
Checkout Provider Index PageThe list of providers that can be used is returned.
Path: https://{commerce_url}/orders/checkout/?page=CheckoutProviderIndexPage
Example Request
There is no need to include any data in the request. Simply submit an empty request.
Example Response
The list of checkout_providers
is returned in the page_context
, and the CheckoutProviderSelectionPage
is called to enable the selection of a checkout from this list.
POST
Checkout Provider Selection Page
POST
Checkout Provider Selection PageThe customer is given the option to choose which checkout provider to use on this page.
Path: https://{commerce_url}/orders/checkout/?page=CheckoutProviderSelectionPage
Example Request
The ID of one of the providers returned for the CheckoutProviderIndexPage
is selected and included in the request with the checkout_provider
field.
Example Response
The redirect_url
is returned in the page_context
, and this URL is saved in the pre_order
as remote_redirect_url
.
POST
Checkout Provider Address Selection Page
POST
Checkout Provider Address Selection PageThis is the page where the user selects the address in Akifast.
Path: https://{commerce_url}/orders/checkout/?page=CheckoutProviderAddressSelectionPage
Example Request
The billing_address
, shipping_address
, session_token
, and basket_id
fields should be sent based on the selected address.
Example Response
A new redirect_url is returned in the page_context as the response.
POST
Checkout Provider Shipping Option Page
POST
Checkout Provider Shipping Option PageThe available shipping companies are listed when the user selects an address in Akifast.
Path: https://{commerce_url}/orders/checkout/?page=CheckoutProviderShippingOptionPage
Example Request
The request should include the basket_id
, conversation_id
, and language
fields in order to list the available shipping companies.
Example Response
The shipping_options
response is returned with the shipping_options
list in the page_context
.
POST
Checkout Provider Agreement List Page
POST
Checkout Provider Agreement List PageThe page displays contract titles.
Path: https://{commerce_url}/orders/checkout/?page=CheckoutProviderAgreementListPage
Example Request
The previously sent information (basket_id
, session_token
, shipping_option_key
, shipping_address
, billing_address
) needs to be sent again on this page. Additionally, include the fields code
and user
in this information.
Example Response
In the response, the agreements
field is returned within the page_context
.
Checkout Provider Notification Page
The page is sent to the shop side for order creation after the payment is received on the Akifast side. The request includes all the necessary information for order creation.
POST
Checkout-Provider-Notification-Page
Path: https://{commerce_url}/orders/checkout/?page=CheckoutProviderNotificationPage
Example Request
To complete a post-negotiation transaction, send the following fields in the request: agreements
, conversation_id
, payment_info
, transaction
, card_info
, shipping_address
, akifast_user
, and is_successful
.
Example Response
After sending the required information, the page_context
returns the following fields: code
, text
, and agreement_body
.
POST
Checkout Provider Thank You Page
POST
Checkout Provider Thank You PageAfter the order is created, a return_url
is generated within the Akifast application. This URL serves as a dynamic address for the thank you page, indicating that your order has been successfully approved.
Path: https://{commerce_url}/orders/checkout/?page=CheckoutProviderThankYouPage
Example Request
There is no need to include any data in the request. Simply submit an empty request.
Example Response
The page_context
returns the return_url
, and the user is redirected to that URL.
GET
Thank You Page
GET
Thank You PageThe thank you page is shown to the user after the order is completed.
Path: https://{commerce_url}/orders/checkout/?page=ThankYouPage
Example Request
There is no need to include any data in the request. Simply submit an empty request.
Example Response
In the response, a redirect_url
is returned which redirects the user to the ThankYouPage
.
POST
Redirect Guard Page
POST
Redirect Guard PageThis page provides a control to ensure successful redirection and prevent further redirection.
Redirect-Guard-Page
Path: https://{commerce_url}/orders/checkout/?page=RedirectGuardPage
Example Request
There is no need to include any data in the request. Simply submit an empty request.
Example Response
No additional data is returned in the response.
POST
Loyalty Card Page
POST
Loyalty Card PageThis page is used to set loyalty point amount.
Path: https://{commerce_url}/orders/checkout/?page=LoyaltyCardPage
Example Request
Include the selected_loyalty_amount
field in the request to indicate the chosen amount.
Example Response
Upon sending the request, the response include fields such as loyalty_total_amount
, loyalty_amount
, card_number
, applied_amount
, and loyalty_points_type
. These fields provide detailed information about the transaction. If the operation is unsuccessful, these fields are returned blank.
POST
Send Barcode SMS Page
POST
Send Barcode SMS PageThis page is used to send barcode SMS to the phone number provided.
Path: https://{commerce_url}/orders/checkout/?page=SendBarcodeSmsPage
Example Request
Include the phone number to which the message is requested in the request.
Example Response
No additional data is returned in the response.
POST
Send Checkout URL SMS Page
POST
Send Checkout URL SMS PageIf a customer does not have a QR reader app and cannot scan the barcode, the checkout URL is sent to them via SMS.
Path: https://{commerce_url}/orders/checkout/?page=SendBarcodeSmsPage
Example Request
Include the phone number to which the message is requested in the request.
Example Response
No additional data is returned in the response.
Last updated
Was this helpful?