创建收款

POST

https://secure.finixpayment.com/v1/api/payment/initiate

此端点允许您在 Finix 上初始化交易，并返回一个结帐 URL，您可以在浏览器中加载该 URL 以向客户显示付款表单。该结帐 URL 的有效期为 30 分钟。

Request

Header Params

Body Params application/json

Example

{
    "merchantRef": "0954f567-ea8f-49b4-920f-c49174aa2c1f",
    "amount": 100,
    "currency": "INR",
    "method": "NATIVE",
    "name": "Lucia Lesch",
    "phone": "82445415208",
    "email": "quinten31@yahoo.com",
    "redirectUrl": "https://www.redirect.com/",
    "webhookUrl": "https://www.webhook.com/"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://secure.finixpayment.com/v1/api/payment/initiate' \
--header 'MerchantID: FX100001' \
--header 'Signature: 7QbwLbLsS0MAVK3RizeDrNrHZYsKheOVE5yrzH2ectK6uwwT3RMtEJjXHaYi2BFcNUuqMqVknbOc0eIatK0r8BQT87i3U60pvVBblrPG02QkHBJYGBel2pH09oUZ0BNSsphZADxvQqTUVkTXbdaBIZYo8GGY3m96Rb5vUToKEzQ66cm3bduhuxjXf12gXoEgoPFQ8vlpXOAlMxQ5ARMylmNv25Ov29gidi4Z0qjimu96FSWcnxcXvIZfQD7HMzhC' \
--header 'Timestamp: 1750553505' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantRef": "0954f567-ea8f-49b4-920f-c49174aa2c1f",
    "amount": 100,
    "currency": "INR",
    "method": "NATIVE",
    "name": "Lucia Lesch",
    "phone": "82445415208",
    "email": "quinten31@yahoo.com",
    "redirectUrl": "https://www.redirect.com/",
    "webhookUrl": "https://www.webhook.com/"
}'

Responses

🟢200Success

application/json

Body

Examples

SUCCESSFAIL

{
    "code": "200",
    "message": "SUCCESS",
    "data": {
        "transactionRef": "d1ebde00-5f4a-4085-9fd6-5e0852af259f",
        "merchantRef": "44021ca9-1acb-4ef4-aebb-8217e75398a9",
        "method": "NATIVE",
        "amount": 100.01,
        "checkoutUrl": "https://www.finixpayment.com/checkout"
    }
}

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

验签

查询收款状态