Create a direct payment

POST

/v1/authorise

Create a direct payment request

Request

Header Params

Body Params application/x-www-form-urlencoded

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/authorise' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'merchant_id={{merchant_id}}' \
--data-urlencode 'account_id={{account_id}}' \
--data-urlencode 'order_no=1726891254563' \
--data-urlencode 'currency=USD' \
--data-urlencode 'amount=10.36' \
--data-urlencode 'item_total=10.00' \
--data-urlencode 'shipping=1.00' \
--data-urlencode 'handling=1.00' \
--data-urlencode 'tax_total=1.00' \
--data-urlencode 'insurance=1.00' \
--data-urlencode 'shipping_discount=1.00' \
--data-urlencode 'discount=1.00' \
--data-urlencode 'website=website.com' \
--data-urlencode 'items=huawei#,#NUM1#,#230.00#,#1#;#Test2#,#NUM2#,#290.00#,#2' \
--data-urlencode 'note=' \
--data-urlencode 'shopper_id=apidog1' \
--data-urlencode 'shopper_email=apidog@gmail.com' \
--data-urlencode 'shopper_ip=219.78.45.63' \
--data-urlencode 'shopper_phone=13012345678' \
--data-urlencode 'shopper_level=1' \
--data-urlencode 'open3d=do3DS' \
--data-urlencode 'token_flag=NO' \
--data-urlencode 'token_id=' \
--data-urlencode 'card=4242424242424242' \
--data-urlencode 'expiration_month=12' \
--data-urlencode 'expiration_year=2030' \
--data-urlencode 'security_code=321' \
--data-urlencode 'first_name=Milton' \
--data-urlencode 'last_name=Braganza' \
--data-urlencode 'document=' \
--data-urlencode 'birth_date=02-02-1920' \
--data-urlencode 'billing_country=CN' \
--data-urlencode 'billing_state=FJ' \
--data-urlencode 'billing_city=Xiamen' \
--data-urlencode 'billing_address=3610  Brighton Circle Road' \
--data-urlencode 'billing_postal_code=56376' \
--data-urlencode 'os=Win10' \
--data-urlencode 'browser=Mozilla/5.0 (Windows NT 10.0; WOW64) …' \
--data-urlencode 'browser_lang=en-US' \
--data-urlencode 'time_zone=8' \
--data-urlencode 'resolution=1920x1080' \
--data-urlencode 'cookie_new=billing_country=US&shopper_email=test@ company.com&time_zone=....' \
--data-urlencode 'cookie_old=billing_country=US&shopper_email=test@ company.com&time_zone=....' \
--data-urlencode 'challenge_window_size=01' \
--data-urlencode 'session_id=' \
--data-urlencode 'delivery_firstname=Li' \
--data-urlencode 'delivery_lastname=Han' \
--data-urlencode 'delivery_country=CN' \
--data-urlencode 'delivery_state=FJ' \
--data-urlencode 'delivery_city=Xiamen' \
--data-urlencode 'delivery_address=3610  Brighton Circle Road' \
--data-urlencode 'delivery_postal_code=56376' \
--data-urlencode 'notify_url={{webUrl}}/v1/pages/NotifyResult.jsp' \
--data-urlencode 'custom=' \
--data-urlencode 'installments=' \
--data-urlencode 'installments_id=' \
--data-urlencode 'device_fingerprint=' \
--data-urlencode 'encryption_data=a290ea1fd6c69d69d578eb15921eb486e4b801c5b6a577df445aa8f6c592b66b' \
--data-urlencode 'platform_source=Shopify' \
--data-urlencode 'device_type=PC' \
--data-urlencode 'order_type=WEB' \
--data-urlencode 'checkout_time=1415273168' \
--data-urlencode 'user_agent=Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36' \
--data-urlencode 'forter_token_cookie=' \
--data-urlencode 'price_id=' \
--data-urlencode 'quote_id=' \
--data-urlencode 'quote_price=' \
--data-urlencode 'color_depth=' \
--data-urlencode 'accept='

Responses

🟢200OK

application/xml

Body

Example

<?xml version="1.0" encoding="UTF-8"?>
<respon>
    <merchant_id>701001</merchant_id>
    <account_id>701001021</account_id>
    <order_no>1726206945985</order_no>
    <amount>10.36</amount>
    <currency>USD</currency>
    <transaction_id>Ca267324866591</transaction_id>
    <card>400000***1091</card>
    <order_status>1</order_status>
    <result_info>0000:Success</result_info>
    <encryption_data>E72300476702EBD9DFF06B51B941BB570C059C9EB1F794E60DD4F78D7A4EBCEF</encryption_data>
    <note></note>
    <connector>AIGLOBALPAY</connector>
</respon>

🟠404Record not found

🟠400Invalid input

Modified at 2025-02-12 07:34:36

Changelog

Create a redirect (iFrame) payment