API
  1. Acquiring
API
  • Guides
    • Welcome
    • Interface
  • API Reference
    • Introduction
    • Endpoints
    • Data Types
    • Signing
    • 3-D Secure Verification
    • Subscription
    • Errors
    • Webhooks
    • Items Information
    • Changelog
    • Acquiring
      • Create a direct payment
        POST
      • Create a APM payment
        POST
      • Create a redirect (iFrame) payment
        POST
      • Query a transaction
        POST
      • Refund a transaction
        POST
      • Search a refund transaction
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Cancel a subscription
        POST
      • Capture a transaction
        POST
      • Create a payout
        POST
      • Optimise payment methods
        POST
    • Issuing
      • Cardholder
        • Create cardholder
          POST
        • Delete cardholder
          POST
        • Query cardholder
          POST
      • Group
        • Create group
        • Query group details
        • Cancel group
        • Refund group
        • Update group status
        • Recharge group
      • Card
        • Create a card
        • Query card BIN
        • Recharge card
        • Withdraw from a card
        • Cancel a card
        • Update card status
        • Update card limit
        • Query card details
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Acquiring

Create a direct payment

POST
/v1/authorise
Create a direct payment request

Request

Header Params

Body Params application/json

Example
{
    "merchant_id": "701001",
    "account_id": "701001010",
    "order_no": "1726891254563",
    "currency": "USD",
    "amount": "10.36",
    "item_total": "10.00",
    "shipping": "1.00",
    "handling": "1.00",
    "tax_total": "1.00",
    "insurance": "1.00",
    "shipping_discount": "1.00",
    "discount": "1.00",
    "website": "website.com",
    "items": "huawei#,#NUM1#,#230.00#,#1#;#Test2#,#NUM2#,#290.00#,#2",
    "note": "",
    "shopper_id": "apidog1",
    "shopper_email": "apidog@gmail.com",
    "shopper_ip": "219.78.45.63",
    "shopper_phone": "13012345678",
    "shopper_level": "1",
    "open3d": "do3DS",
    "token_flag": "NO",
    "token_id": "",
    "card": "4242424242424242",
    "expiration_month": "12",
    "expiration_year": "2030",
    "security_code": "321",
    "first_name": "Milton",
    "last_name": "Braganza",
    "notify_url": "{{webUrl}}/v1/pages/NotifyResult.jsp",
    "document": "",
    "birth_date": "02-02-1920",
    "billing_country": "CN",
    "billing_state": "FJ",
    "billing_city": "Xiamen",
    "billing_address": "3610  Brighton Circle Road",
    "billing_postal_code": "56376",
    "os": "Win10",
    "browser": "Mozilla/5.0 (Windows NT 10.0; WOW64) …",
    "browser_lang": "en-US",
    "time_zone": "8",
    "resolution": "1920x1080",
    "cookie_new": "billing_country=US&shopper_email=test@ company.com&time_zone=.... ",
    "cookie_old": "billing_country=US&shopper_email=test@ company.com&time_zone=.... ",
    "challenge_window_size": "01",
    "session_id": "",
    "delivery_firstname": "Li",
    "delivery_lastname": "Han",
    "delivery_country": "CN",
    "delivery_state": "FJ",
    "delivery_city": "Xiamen",
    "delivery_address": "3610  Brighton Circle Road",
    "delivery_postal_code": "56376",
    "custom": "",
    "installments": "",
    "installments_id": "",
    "device_fingerprint": "",
    "encryption_data": "{{sign}}",
    "platform_source": "Shopify",
    "device_type": "PC",
    "order_type": "WEB",
    "checkout_time": 1415273168,
    "user_agent": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36",
    "forter_token_cookie": "",
    "cart_items": [
        {
            "basic_item_data": {
                "name": "string",
                "quantity": "string",
                "type": "string",
                "price": {
                    "amount_usd": 0,
                    "amount_local_currency": 0,
                    "currency": "str"
                },
                "category": "string",
                "productId": "string"
            }
        }
    ],
    "account_owner": [
        {
            "first_name": "string",
            "last_name": "string",
            "email": "string",
            "account_id": "string",
            "created": 0,
            "past_orders_count": 0,
            "past_orders_sum": 0,
            "lastLogin_ip": "string",
            "registration_ip": "string"
        }
    ],
    "total_discount": [
        {
            "coupon_code_used": "string",
            "discount_type": "string"
        }
    ],
    "additional_information": [
        {
            "mpi_info": {
                "eci": "st",
                "cavv": "string",
                "xid": "string",
                "dsTransID": "string"
            }
        }
    ],
    "price_id": "string",
    "quote_id": "string",
    "quote_price": "string",
    "color_depth": "test",
    "accept": "string",
    "subscription": {
        "contract": "string",
        "contract_name": "string",
        "interval": "day",
        "interval_count": "string",
        "billing_cycle": 0,
        "promotion_cycle": 0,
        "contract_start": "string",
        "contract_end": "string",
        "price_id": "string"
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test-api.sufupayment.com/v1/authorise' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-raw '{
    "merchant_id": "701001",
    "account_id": "701001010",
    "order_no": "1726891254563",
    "currency": "USD",
    "amount": "10.36",
    "item_total": "10.00",
    "shipping": "1.00",
    "handling": "1.00",
    "tax_total": "1.00",
    "insurance": "1.00",
    "shipping_discount": "1.00",
    "discount": "1.00",
    "website": "website.com",
    "items": "huawei#,#NUM1#,#230.00#,#1#;#Test2#,#NUM2#,#290.00#,#2",
    "note": "",
    "shopper_id": "apidog1",
    "shopper_email": "apidog@gmail.com",
    "shopper_ip": "219.78.45.63",
    "shopper_phone": "13012345678",
    "shopper_level": "1",
    "open3d": "do3DS",
    "token_flag": "NO",
    "token_id": "",
    "card": "4242424242424242",
    "expiration_month": "12",
    "expiration_year": "2030",
    "security_code": "321",
    "first_name": "Milton",
    "last_name": "Braganza",
    "notify_url": "https://test-api.sufupayment.com/v1/pages/NotifyResult.jsp",
    "document": "",
    "birth_date": "02-02-1920",
    "billing_country": "CN",
    "billing_state": "FJ",
    "billing_city": "Xiamen",
    "billing_address": "3610  Brighton Circle Road",
    "billing_postal_code": "56376",
    "os": "Win10",
    "browser": "Mozilla/5.0 (Windows NT 10.0; WOW64) …",
    "browser_lang": "en-US",
    "time_zone": "8",
    "resolution": "1920x1080",
    "cookie_new": "billing_country=US&shopper_email=test@ company.com&time_zone=.... ",
    "cookie_old": "billing_country=US&shopper_email=test@ company.com&time_zone=.... ",
    "challenge_window_size": "01",
    "session_id": "",
    "delivery_firstname": "Li",
    "delivery_lastname": "Han",
    "delivery_country": "CN",
    "delivery_state": "FJ",
    "delivery_city": "Xiamen",
    "delivery_address": "3610  Brighton Circle Road",
    "delivery_postal_code": "56376",
    "custom": "",
    "installments": "",
    "installments_id": "",
    "device_fingerprint": "",
    "encryption_data": "{{sign}}",
    "platform_source": "Shopify",
    "device_type": "PC",
    "order_type": "WEB",
    "checkout_time": 1415273168,
    "user_agent": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36",
    "forter_token_cookie": "",
    "cart_items": [
        {
            "basic_item_data": {
                "name": "string",
                "quantity": "string",
                "type": "string",
                "price": {
                    "amount_usd": 0,
                    "amount_local_currency": 0,
                    "currency": "str"
                },
                "category": "string",
                "productId": "string"
            }
        }
    ],
    "account_owner": [
        {
            "first_name": "string",
            "last_name": "string",
            "email": "string",
            "account_id": "string",
            "created": 0,
            "past_orders_count": 0,
            "past_orders_sum": 0,
            "lastLogin_ip": "string",
            "registration_ip": "string"
        }
    ],
    "total_discount": [
        {
            "coupon_code_used": "string",
            "discount_type": "string"
        }
    ],
    "additional_information": [
        {
            "mpi_info": {
                "eci": "st",
                "cavv": "string",
                "xid": "string",
                "dsTransID": "string"
            }
        }
    ],
    "price_id": "string",
    "quote_id": "string",
    "quote_price": "string",
    "color_depth": "test",
    "accept": "string",
    "subscription": {
        "contract": "string",
        "contract_name": "string",
        "interval": "day",
        "interval_count": "string",
        "billing_cycle": 0,
        "promotion_cycle": 0,
        "contract_start": "string",
        "contract_end": "string",
        "price_id": "string"
    }
}'

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>
    <contract_name>Recurring Order</contract_name>
    <recurring_id>Recurring_12345</recurring_id>
    <recurring_deduction_period>1</recurring_deduction_period>
    <recurring_deduction_time>2025-03-25 14:30:00</recurring_deduction_time>
    <note></note>
    <token_id>23432G233423GSDF234</token_id>
    <connector>AIGLOBALPAY</connector>
    <threeds_result>Cardholder authenticated</threeds_result>
    <risk_action>ACCEPT</risk_action>
    <risk_score>0</risk_score>
    <risk_reasons>
        <name></name>
        <status></status>
    </risk_reasons>
    <encryption_data>E72300476702EBD9DFF06B51B941BB570C059C9EB1F794E60DD4F78D7A4EBCEF</encryption_data>
</respon>
🟠404Record not found
🟠400Invalid input
Modified at 2025-05-30 05:28:58
Previous
Changelog
Next
Create a APM payment