跳转至

支付宝☍

版本：v1

认证方式：Bearer Token

目录☍

接口列表☍

创建订单 - 当面付☍

接口说明

创建一个当面付订单，并返回支付二维码。

基本信息☍

  • 接口名称：创建订单 - 当面付
  • 请求方式：POST
  • 请求路径：/Alipay/{appKey}/CreateOrder

请求参数☍

Path 参数☍
参数名 示例值 参数描述 是否必填
appKey - - 是
Body 参数☍
参数名 类型 示例值 参数描述 是否必填
orderNo string - 自定义订单号 是
amount number - 订单金额。例如：0.01 是
subject string - 商品名称 是
returnUrl string - 支付完成后返回的URL地址 否

示例代码☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;


public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();

        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create("{server}/Alipay/{appKey}/CreateOrder"))
            .header("Authorization", "Bearer {your_access_token}")
            .header("Content-Type", "application/json");



        // 创建请求体数据
        Map<String, Object> data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
        ObjectMapper mapper = new ObjectMapper();
        String jsonBody = mapper.writeValueAsString(data);
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), jsonBody);

        requestBuilder.method("post", HttpRequest.BodyPublishers.ofString(jsonBody));

        try {
            HttpResponse<String> response = client.send(requestBuilder.build(), HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
import requests

url = "{server}/Alipay/{appKey}/CreateOrder"
headers = {
    "Authorization": "Bearer {your_access_token}",
    "Content-Type": "application/json"
}


data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}

response = requests.post(
    url,
    headers=headers,
    json=data
)

print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    client := &http.Client{}

    var req *http.Request
    var err error


    data := {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
    jsonBody, err := json.Marshal(data)
    if err != nil {
        panic(err)
    }

    req, err = http.NewRequest("post", "{server}/Alipay/{appKey}/CreateOrder", bytes.NewBuffer(jsonBody))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Content-Type", "application/json")

    req.Header.Add("Authorization", "Bearer {your_access_token}")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
const axios = require('axios');


const data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

const config = {
    method: 'post',
    url: '{server}/Alipay/{appKey}/CreateOrder',
    headers: {
        'Authorization': 'Bearer {your_access_token}',
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<?php

$url = "{server}/Alipay/{appKey}/CreateOrder";
$headers = [
    "Authorization: Bearer {your_access_token}",
    "Content-Type: application/json"
];


$data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "post");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Text;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer {your_access_token}");

            HttpResponseMessage response;


            var data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
            var content = new StringContent(
                JsonSerializer.Serialize(data),
                Encoding.UTF8,
                "application/json");
            response = await client.postAsync("{server}/Alipay/{appKey}/CreateOrder", content);

            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
require 'net/http'
require 'json'

uri = URI("{server}/Alipay/{appKey}/CreateOrder")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::undefined.new(uri)
request["Authorization"] = "Bearer {your_access_token}"
request["Content-Type"] = "application/json"


data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
request.set_form_data(data)

response = http.request(request)
puts response.body

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
const data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

fetch("{server}/Alipay/{appKey}/CreateOrder", {
    method: "post",
    headers: {
        "Authorization": "Bearer {your_access_token}",
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.catch(error => console.error(error));

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.MediaType;
import okhttp3.RequestBody;
import org.json.JSONObject;


public class ApiClient {
    private final OkHttpClient client = new OkHttpClient();

    public void makeRequest() {
        Request.Builder requestBuilder = new Request.Builder()
            .url("{server}/Alipay/{appKey}/CreateOrder")
            .addHeader("Authorization", "Bearer {your_access_token}")
            .addHeader("Content-Type", "application/json");


        JSONObject data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), data.toString());

        requestBuilder.method("post", body);

        try (Response response = client.newCall(requestBuilder.build()).execute()) {
            System.out.println(response.body().string());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import Foundation

let url = URL(string: "{server}/Alipay/{appKey}/CreateOrder")!
var request = URLRequest(url: url)
request.httpMethod = "post"
request.setValue("Bearer {your_access_token}", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")


let data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
let jsonData = try? JSONSerialization.data(withJSONObject: data)
request.httpBody = jsonData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        if let json = try? JSONSerialization.jsonObject(with: data) {
            print(json)
        }
    }
}
task.resume()

返回结果☍

1
2
3
4
5
{
    "code": 200          // 状态码,
    "data": ""          // 响应数据,
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data string 响应数据 否
error string 错误信息 否

创建订单 - PC支付☍

接口说明

创建一个PC支付订单，并返回支付页面。

基本信息☍

  • 接口名称：创建订单 - PC支付
  • 请求方式：POST
  • 请求路径：/Alipay/{appKey}/CreateOrderPagePay

请求参数☍

Path 参数☍
参数名 示例值 参数描述 是否必填
appKey - - 是
Body 参数☍
参数名 类型 示例值 参数描述 是否必填
orderNo string - 自定义订单号 是
amount number - 订单金额。例如：0.01 是
subject string - 商品名称 是
returnUrl string - 支付完成后返回的URL地址 否

示例代码☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;


public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();

        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create("{server}/Alipay/{appKey}/CreateOrderPagePay"))
            .header("Authorization", "Bearer {your_access_token}")
            .header("Content-Type", "application/json");



        // 创建请求体数据
        Map<String, Object> data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
        ObjectMapper mapper = new ObjectMapper();
        String jsonBody = mapper.writeValueAsString(data);
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), jsonBody);

        requestBuilder.method("post", HttpRequest.BodyPublishers.ofString(jsonBody));

        try {
            HttpResponse<String> response = client.send(requestBuilder.build(), HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
import requests

url = "{server}/Alipay/{appKey}/CreateOrderPagePay"
headers = {
    "Authorization": "Bearer {your_access_token}",
    "Content-Type": "application/json"
}


data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}

response = requests.post(
    url,
    headers=headers,
    json=data
)

print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    client := &http.Client{}

    var req *http.Request
    var err error


    data := {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
    jsonBody, err := json.Marshal(data)
    if err != nil {
        panic(err)
    }

    req, err = http.NewRequest("post", "{server}/Alipay/{appKey}/CreateOrderPagePay", bytes.NewBuffer(jsonBody))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Content-Type", "application/json")

    req.Header.Add("Authorization", "Bearer {your_access_token}")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
const axios = require('axios');


const data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

const config = {
    method: 'post',
    url: '{server}/Alipay/{appKey}/CreateOrderPagePay',
    headers: {
        'Authorization': 'Bearer {your_access_token}',
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<?php

$url = "{server}/Alipay/{appKey}/CreateOrderPagePay";
$headers = [
    "Authorization: Bearer {your_access_token}",
    "Content-Type: application/json"
];


$data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "post");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Text;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer {your_access_token}");

            HttpResponseMessage response;


            var data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
            var content = new StringContent(
                JsonSerializer.Serialize(data),
                Encoding.UTF8,
                "application/json");
            response = await client.postAsync("{server}/Alipay/{appKey}/CreateOrderPagePay", content);

            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
require 'net/http'
require 'json'

uri = URI("{server}/Alipay/{appKey}/CreateOrderPagePay")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::undefined.new(uri)
request["Authorization"] = "Bearer {your_access_token}"
request["Content-Type"] = "application/json"


data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
request.set_form_data(data)

response = http.request(request)
puts response.body

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
const data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

fetch("{server}/Alipay/{appKey}/CreateOrderPagePay", {
    method: "post",
    headers: {
        "Authorization": "Bearer {your_access_token}",
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.catch(error => console.error(error));

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.MediaType;
import okhttp3.RequestBody;
import org.json.JSONObject;


public class ApiClient {
    private final OkHttpClient client = new OkHttpClient();

    public void makeRequest() {
        Request.Builder requestBuilder = new Request.Builder()
            .url("{server}/Alipay/{appKey}/CreateOrderPagePay")
            .addHeader("Authorization", "Bearer {your_access_token}")
            .addHeader("Content-Type", "application/json");


        JSONObject data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), data.toString());

        requestBuilder.method("post", body);

        try (Response response = client.newCall(requestBuilder.build()).execute()) {
            System.out.println(response.body().string());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import Foundation

let url = URL(string: "{server}/Alipay/{appKey}/CreateOrderPagePay")!
var request = URLRequest(url: url)
request.httpMethod = "post"
request.setValue("Bearer {your_access_token}", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")


let data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
let jsonData = try? JSONSerialization.data(withJSONObject: data)
request.httpBody = jsonData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        if let json = try? JSONSerialization.jsonObject(with: data) {
            print(json)
        }
    }
}
task.resume()

返回结果☍

1
2
3
4
5
{
    "code": 200          // 状态码,
    "data": ""          // 响应数据,
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data string 响应数据 否
error string 错误信息 否

创建订单 - WAP支付☍

接口说明

创建一个WAP支付订单，并返回支付页面。

基本信息☍

  • 接口名称：创建订单 - WAP支付
  • 请求方式：POST
  • 请求路径：/Alipay/{appKey}/CreateOrderWapPay

请求参数☍

Path 参数☍
参数名 示例值 参数描述 是否必填
appKey - - 是
Body 参数☍
参数名 类型 示例值 参数描述 是否必填
orderNo string - 自定义订单号 是
amount number - 订单金额。例如：0.01 是
subject string - 商品名称 是
returnUrl string - 支付完成后返回的URL地址 否

示例代码☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;


public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();

        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create("{server}/Alipay/{appKey}/CreateOrderWapPay"))
            .header("Authorization", "Bearer {your_access_token}")
            .header("Content-Type", "application/json");



        // 创建请求体数据
        Map<String, Object> data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
        ObjectMapper mapper = new ObjectMapper();
        String jsonBody = mapper.writeValueAsString(data);
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), jsonBody);

        requestBuilder.method("post", HttpRequest.BodyPublishers.ofString(jsonBody));

        try {
            HttpResponse<String> response = client.send(requestBuilder.build(), HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
import requests

url = "{server}/Alipay/{appKey}/CreateOrderWapPay"
headers = {
    "Authorization": "Bearer {your_access_token}",
    "Content-Type": "application/json"
}


data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}

response = requests.post(
    url,
    headers=headers,
    json=data
)

print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    client := &http.Client{}

    var req *http.Request
    var err error


    data := {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
    jsonBody, err := json.Marshal(data)
    if err != nil {
        panic(err)
    }

    req, err = http.NewRequest("post", "{server}/Alipay/{appKey}/CreateOrderWapPay", bytes.NewBuffer(jsonBody))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Content-Type", "application/json")

    req.Header.Add("Authorization", "Bearer {your_access_token}")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
const axios = require('axios');


const data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

const config = {
    method: 'post',
    url: '{server}/Alipay/{appKey}/CreateOrderWapPay',
    headers: {
        'Authorization': 'Bearer {your_access_token}',
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<?php

$url = "{server}/Alipay/{appKey}/CreateOrderWapPay";
$headers = [
    "Authorization: Bearer {your_access_token}",
    "Content-Type: application/json"
];


$data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "post");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Text;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer {your_access_token}");

            HttpResponseMessage response;


            var data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
            var content = new StringContent(
                JsonSerializer.Serialize(data),
                Encoding.UTF8,
                "application/json");
            response = await client.postAsync("{server}/Alipay/{appKey}/CreateOrderWapPay", content);

            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
require 'net/http'
require 'json'

uri = URI("{server}/Alipay/{appKey}/CreateOrderWapPay")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::undefined.new(uri)
request["Authorization"] = "Bearer {your_access_token}"
request["Content-Type"] = "application/json"


data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
request.set_form_data(data)

response = http.request(request)
puts response.body

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
const data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};

fetch("{server}/Alipay/{appKey}/CreateOrderWapPay", {
    method: "post",
    headers: {
        "Authorization": "Bearer {your_access_token}",
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.catch(error => console.error(error));

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.MediaType;
import okhttp3.RequestBody;
import org.json.JSONObject;


public class ApiClient {
    private final OkHttpClient client = new OkHttpClient();

    public void makeRequest() {
        Request.Builder requestBuilder = new Request.Builder()
            .url("{server}/Alipay/{appKey}/CreateOrderWapPay")
            .addHeader("Authorization", "Bearer {your_access_token}")
            .addHeader("Content-Type", "application/json");


        JSONObject data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
};
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), data.toString());

        requestBuilder.method("post", body);

        try (Response response = client.newCall(requestBuilder.build()).execute()) {
            System.out.println(response.body().string());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import Foundation

let url = URL(string: "{server}/Alipay/{appKey}/CreateOrderWapPay")!
var request = URLRequest(url: url)
request.httpMethod = "post"
request.setValue("Bearer {your_access_token}", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")


let data = {
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
let jsonData = try? JSONSerialization.data(withJSONObject: data)
request.httpBody = jsonData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        if let json = try? JSONSerialization.jsonObject(with: data) {
            print(json)
        }
    }
}
task.resume()

返回结果☍

1
2
3
4
5
{
    "code": 200          // 状态码,
    "data": ""          // 响应数据,
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data string 响应数据 否
error string 错误信息 否

订单详情☍

接口说明

查询订单详情，包括订单状态和支付信息。

基本信息☍

  • 接口名称：订单详情
  • 请求方式：GET
  • 请求路径：/Alipay/{appKey}/OrderDetail

请求参数☍

Path 参数☍
参数名 示例值 参数描述 是否必填
appKey - - 是
Query 参数☍
参数名 类型 示例值 参数描述 是否必填
orderNo string - 订单号 否

示例代码☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;


public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();

        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create("{server}/Alipay/{appKey}/OrderDetail"))
            .header("Authorization", "Bearer {your_access_token}");


        requestBuilder.method("get", HttpRequest.BodyPublishers.noBody());

        try {
            HttpResponse<String> response = client.send(requestBuilder.build(), HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
import requests

url = "{server}/Alipay/{appKey}/OrderDetail"
headers = {
    "Authorization": "Bearer {your_access_token}"
}

response = requests.get(
    url,
    headers=headers
)

print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    client := &http.Client{}

    var req *http.Request
    var err error

    req, err = http.NewRequest("get", "{server}/Alipay/{appKey}/OrderDetail", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Add("Authorization", "Bearer {your_access_token}")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
const axios = require('axios');

const config = {
    method: 'get',
    url: '{server}/Alipay/{appKey}/OrderDetail',
    headers: {
        'Authorization': 'Bearer {your_access_token}'
    }
};

axios(config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
<?php

$url = "{server}/Alipay/{appKey}/OrderDetail";
$headers = [
    "Authorization: Bearer {your_access_token}"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "get");

$response = curl_exec($ch);
curl_close($ch);

echo $response;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Text;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer {your_access_token}");

            HttpResponseMessage response;
            response = await client.getAsync("{server}/Alipay/{appKey}/OrderDetail");

            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
require 'net/http'
require 'json'

uri = URI("{server}/Alipay/{appKey}/OrderDetail")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::undefined.new(uri)
request["Authorization"] = "Bearer {your_access_token}"

response = http.request(request)
puts response.body

1
2
3
4
5
6
7
8
fetch("{server}/Alipay/{appKey}/OrderDetail", {
    method: "get",
    headers: {
        "Authorization": "Bearer {your_access_token}"
    }
})
.then(response => response.json())
.catch(error => console.error(error));

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.MediaType;
import okhttp3.RequestBody;
import org.json.JSONObject;


public class ApiClient {
    private final OkHttpClient client = new OkHttpClient();

    public void makeRequest() {
        Request.Builder requestBuilder = new Request.Builder()
            .url("{server}/Alipay/{appKey}/OrderDetail")
            .addHeader("Authorization", "Bearer {your_access_token}");
        requestBuilder.method("get", null);

        try (Response response = client.newCall(requestBuilder.build()).execute()) {
            System.out.println(response.body().string());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
import Foundation

let url = URL(string: "{server}/Alipay/{appKey}/OrderDetail")!
var request = URLRequest(url: url)
request.httpMethod = "get"
request.setValue("Bearer {your_access_token}", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        if let json = try? JSONSerialization.jsonObject(with: data) {
            print(json)
        }
    }
}
task.resume()

返回结果☍

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
{
    "code": 200          // 状态码,
    "data": {
    "code": "",
    "msg": "",
    "subCode": "",
    "subMsg": "",
    "isError": false,
    "additionalStatus": "",
    "alipayStoreId": "",
    "alipaySubMerchantId": "",
    "asyncPayApplyStatus": "",
    "authTradePayMode": "",
    "bizSettleMode": "",
    "bkagentRespInfo": {
    "bindclrissrId": "",
    "bindpyeracctbkId": "",
    "bindtrxId": "",
    "bkpyeruserCode": "",
    "estterLocation": ""
},
    "body": "",
    "buyerLogonId": "",
    "buyerOpenId": "",
    "buyerPayAmount": "",
    "buyerUserId": "",
    "buyerUserName": "",
    "buyerUserType": "",
    "cashierType": "",
    "chargeAmount": "",
    "chargeFlags": "",
    "chargeInfoList": [
      {
          "chargeFee": "",
          "chargeType": "",
          "isRatingOnSwitch": "",
          "isRatingOnTradeReceiver": "",
          "originalChargeFee": "",
          "subFeeDetailList": [
            {
                "chargeFee": "",
                "originalChargeFee": "",
                "switchFeeRate": ""
            }
          ],
          "switchFeeRate": ""
      }
    ],
    "creditBizOrderId": "",
    "creditPayMode": "",
    "discountAmount": "",
    "discountGoodsDetail": "",
    "enterprisePayInfo": {
    "bizInfo": "",
    "invoiceAmount": "",
    "isUseEnterprisePay": false
},
    "extInfos": "",
    "fulfillmentDetailList": [
      {
          "fulfillmentAmount": "",
          "gmtPayment": "",
          "outRequestNo": ""
      }
    ],
    "fundBillList": [
      {
          "amount": "",
          "bankCode": "",
          "fundChannel": "",
          "fundType": "",
          "realAmount": ""
      }
    ],
    "hbFqPayInfo": {
    "fqAmount": "",
    "userInstallNum": ""
},
    "hybAmount": "",
    "industrySepcDetail": "",
    "industrySepcDetailAcc": "",
    "industrySepcDetailGov": "",
    "intactChargeInfoList": [
      {
          "actualAmount": "",
          "billType": "",
          "gmtPay": "",
          "isRefund": false,
          "outBizNo": "",
          "planAmount": "",
          "productName": "",
          "serviceTarget": "",
          "serviceType": "",
          "status": "",
          "targetAccountNo": "",
          "targetUserId": ""
      }
    ],
    "invoiceAmount": "",
    "mdiscountAmount": "",
    "medicalInsuranceInfo": "",
    "openId": "",
    "outTradeNo": "",
    "passbackParams": "",
    "payAmount": "",
    "payCurrency": "",
    "paymentInfoWithIdList": [
      {
          "paymentIds": [],
          "type": ""
      }
    ],
    "periodScene": "",
    "pointAmount": "",
    "preAuthPayAmount": "",
    "receiptAmount": "",
    "receiptCurrencyType": "",
    "reqGoodsDetail": [
      {
          "alipayGoodsId": "",
          "body": "",
          "categoriesTree": "",
          "goodsCategory": "",
          "goodsId": "",
          "goodsName": "",
          "outItemId": "",
          "outSkuId": "",
          "price": "",
          "quantity": "0",
          "showUrl": ""
      }
    ],
    "sendPayDate": "",
    "settleAmount": "",
    "settleCurrency": "",
    "settleTransRate": "",
    "settlementId": "",
    "storeId": "",
    "storeName": "",
    "subject": "",
    "tapPayInfo": {
    "paymentMediumType": ""
},
    "terminalId": "",
    "totalAmount": "",
    "tradeNo": "",
    "tradeSettleInfo": {
    "tradeSettleDetailList": [
      {
          "amount": "",
          "operationDt": "",
          "operationSerialNo": "",
          "operationType": "",
          "oriTransIn": "",
          "oriTransOut": "",
          "transIn": "",
          "transOut": ""
      }
    ],
    "tradeUnsettledAmount": ""
},
    "tradeStatus": "",
    "transCurrency": "",
    "transPayRate": "",
    "voucherDetailList": [
      {
          "amount": "",
          "id": "",
          "memo": "",
          "merchantContribute": "",
          "name": "",
          "otherContribute": "",
          "otherContributeDetail": [
            {
                "contributeAmount": "",
                "contributeType": ""
            }
          ],
          "purchaseAntContribute": "",
          "purchaseBuyerContribute": "",
          "purchaseMerchantContribute": "",
          "templateId": "",
          "type": ""
      }
    ]
},
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data AlipayTradeQueryResponse - 否
error string 错误信息 否

订单退款☍

接口说明

对指定订单进行退款操作。

基本信息☍

  • 接口名称：订单退款
  • 请求方式：POST
  • 请求路径：/Alipay/{appKey}/OrderRefund

请求参数☍

Path 参数☍
参数名 示例值 参数描述 是否必填
appKey - - 是
Query 参数☍
参数名 类型 示例值 参数描述 是否必填
amount string - 退款金额 否
orderNo string - 订单号 否

示例代码☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;


public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();

        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create("{server}/Alipay/{appKey}/OrderRefund"))
            .header("Authorization", "Bearer {your_access_token}");


        requestBuilder.method("post", HttpRequest.BodyPublishers.noBody());

        try {
            HttpResponse<String> response = client.send(requestBuilder.build(), HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
import requests

url = "{server}/Alipay/{appKey}/OrderRefund"
headers = {
    "Authorization": "Bearer {your_access_token}"
}

response = requests.post(
    url,
    headers=headers
)

print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    client := &http.Client{}

    var req *http.Request
    var err error

    req, err = http.NewRequest("post", "{server}/Alipay/{appKey}/OrderRefund", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Add("Authorization", "Bearer {your_access_token}")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
const axios = require('axios');

const config = {
    method: 'post',
    url: '{server}/Alipay/{appKey}/OrderRefund',
    headers: {
        'Authorization': 'Bearer {your_access_token}'
    }
};

axios(config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
<?php

$url = "{server}/Alipay/{appKey}/OrderRefund";
$headers = [
    "Authorization: Bearer {your_access_token}"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "post");

$response = curl_exec($ch);
curl_close($ch);

echo $response;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Text;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer {your_access_token}");

            HttpResponseMessage response;
            response = await client.postAsync("{server}/Alipay/{appKey}/OrderRefund");

            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
require 'net/http'
require 'json'

uri = URI("{server}/Alipay/{appKey}/OrderRefund")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::undefined.new(uri)
request["Authorization"] = "Bearer {your_access_token}"

response = http.request(request)
puts response.body

1
2
3
4
5
6
7
8
fetch("{server}/Alipay/{appKey}/OrderRefund", {
    method: "post",
    headers: {
        "Authorization": "Bearer {your_access_token}"
    }
})
.then(response => response.json())
.catch(error => console.error(error));

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.MediaType;
import okhttp3.RequestBody;
import org.json.JSONObject;


public class ApiClient {
    private final OkHttpClient client = new OkHttpClient();

    public void makeRequest() {
        Request.Builder requestBuilder = new Request.Builder()
            .url("{server}/Alipay/{appKey}/OrderRefund")
            .addHeader("Authorization", "Bearer {your_access_token}");
        requestBuilder.method("post", null);

        try (Response response = client.newCall(requestBuilder.build()).execute()) {
            System.out.println(response.body().string());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
import Foundation

let url = URL(string: "{server}/Alipay/{appKey}/OrderRefund")!
var request = URLRequest(url: url)
request.httpMethod = "post"
request.setValue("Bearer {your_access_token}", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        if let json = try? JSONSerialization.jsonObject(with: data) {
            print(json)
        }
    }
}
task.resume()

返回结果☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
{
    "code": 200          // 状态码,
    "data": {
    "code": "",
    "msg": "",
    "subCode": "",
    "subMsg": "",
    "body": "",
    "isError": false,
    "buyerLogonId": "",
    "buyerOpenId": "",
    "buyerUserId": "",
    "fundChange": "",
    "gmtRefundPay": "",
    "hasDepositBack": "",
    "openId": "",
    "outTradeNo": "",
    "preAuthCancelFee": "",
    "presentRefundBuyerAmount": "",
    "presentRefundDiscountAmount": "",
    "presentRefundMdiscountAmount": "",
    "refundChargeAmount": "",
    "refundChargeInfoList": [
      {
          "chargeType": "",
          "refundChargeFee": "",
          "refundSubFeeDetailList": [
            {
                "refundChargeFee": "",
                "switchFeeRate": ""
            }
          ],
          "switchFeeRate": ""
      }
    ],
    "refundCurrency": "",
    "refundDetailItemList": [
      {
          "amount": "",
          "bankCode": "",
          "fundChannel": "",
          "fundType": "",
          "realAmount": ""
      }
    ],
    "refundFee": "",
    "refundHybAmount": "",
    "refundPresetPaytoolList": {
    "amount": [],
    "assertTypeCode": ""
},
    "refundSettlementId": "",
    "refundVoucherDetailList": [
      {
          "amount": "",
          "id": "",
          "memo": "",
          "merchantContribute": "",
          "name": "",
          "otherContribute": "",
          "otherContributeDetail": [
            {
                "contributeAmount": "",
                "contributeType": ""
            }
          ],
          "purchaseAntContribute": "",
          "purchaseBuyerContribute": "",
          "purchaseMerchantContribute": "",
          "templateId": "",
          "type": ""
      }
    ],
    "sendBackFee": "",
    "storeName": "",
    "tradeNo": ""
},
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data AlipayTradeRefundResponse - 否
error string 错误信息 否

支付成功同步通知☍

接口说明

处理支付宝支付成功的同步通知。

基本信息☍

  • 接口名称：支付成功同步通知
  • 请求方式：POST
  • 请求路径：/Alipay/{appKey}/ReturnPageNotify

请求参数☍

Path 参数☍
参数名 示例值 参数描述 是否必填
appKey - - 是
Body 参数☍
参数名 类型 示例值 参数描述 是否必填
app_id string - 应用ID 否
auth_app_id string - 授权应用ID 否
charset string - 字符集 否
method string - 接口名称 否
out_trade_no string - 商户订单号 否
seller_id string - 卖家支付宝用户号 否
sign string - 签名 否
sign_type string - 签名类型 否
timestamp string - 时间戳 否
total_amount string - 订单总金额 否
trade_no string - 支付宝交易号 否
version string - 接口版本 否

示例代码☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;


public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();

        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create("{server}/Alipay/{appKey}/ReturnPageNotify"))
            .header("Authorization", "Bearer {your_access_token}")
            .header("Content-Type", "application/json");



        // 创建请求体数据
        Map<String, Object> data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
};
        ObjectMapper mapper = new ObjectMapper();
        String jsonBody = mapper.writeValueAsString(data);
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), jsonBody);

        requestBuilder.method("post", HttpRequest.BodyPublishers.ofString(jsonBody));

        try {
            HttpResponse<String> response = client.send(requestBuilder.build(), HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import requests

url = "{server}/Alipay/{appKey}/ReturnPageNotify"
headers = {
    "Authorization": "Bearer {your_access_token}",
    "Content-Type": "application/json"
}


data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
}

response = requests.post(
    url,
    headers=headers,
    json=data
)

print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    client := &http.Client{}

    var req *http.Request
    var err error


    data := {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
}
    jsonBody, err := json.Marshal(data)
    if err != nil {
        panic(err)
    }

    req, err = http.NewRequest("post", "{server}/Alipay/{appKey}/ReturnPageNotify", bytes.NewBuffer(jsonBody))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Content-Type", "application/json")

    req.Header.Add("Authorization", "Bearer {your_access_token}")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
const axios = require('axios');


const data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
};

const config = {
    method: 'post',
    url: '{server}/Alipay/{appKey}/ReturnPageNotify',
    headers: {
        'Authorization': 'Bearer {your_access_token}',
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<?php

$url = "{server}/Alipay/{appKey}/ReturnPageNotify";
$headers = [
    "Authorization: Bearer {your_access_token}",
    "Content-Type: application/json"
];


$data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
};

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "post");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Text;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer {your_access_token}");

            HttpResponseMessage response;


            var data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
};
            var content = new StringContent(
                JsonSerializer.Serialize(data),
                Encoding.UTF8,
                "application/json");
            response = await client.postAsync("{server}/Alipay/{appKey}/ReturnPageNotify", content);

            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
require 'net/http'
require 'json'

uri = URI("{server}/Alipay/{appKey}/ReturnPageNotify")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::undefined.new(uri)
request["Authorization"] = "Bearer {your_access_token}"
request["Content-Type"] = "application/json"


data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
}
request.set_form_data(data)

response = http.request(request)
puts response.body

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
const data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
};

fetch("{server}/Alipay/{appKey}/ReturnPageNotify", {
    method: "post",
    headers: {
        "Authorization": "Bearer {your_access_token}",
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.catch(error => console.error(error));

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.MediaType;
import okhttp3.RequestBody;
import org.json.JSONObject;


public class ApiClient {
    private final OkHttpClient client = new OkHttpClient();

    public void makeRequest() {
        Request.Builder requestBuilder = new Request.Builder()
            .url("{server}/Alipay/{appKey}/ReturnPageNotify")
            .addHeader("Authorization", "Bearer {your_access_token}")
            .addHeader("Content-Type", "application/json");


        JSONObject data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
};
        RequestBody body = RequestBody.create(
            MediaType.parse("application/json"), data.toString());

        requestBuilder.method("post", body);

        try (Response response = client.newCall(requestBuilder.build()).execute()) {
            System.out.println(response.body().string());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
import Foundation

let url = URL(string: "{server}/Alipay/{appKey}/ReturnPageNotify")!
var request = URLRequest(url: url)
request.httpMethod = "post"
request.setValue("Bearer {your_access_token}", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")


let data = {
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
}
let jsonData = try? JSONSerialization.data(withJSONObject: data)
request.httpBody = jsonData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        if let json = try? JSONSerialization.jsonObject(with: data) {
            print(json)
        }
    }
}
task.resume()

返回结果☍

1
2
3
4
5
{
    "code": 200          // 状态码,
    "data": false          // 响应数据,
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data boolean 响应数据 否
error string 错误信息 否

数据结构☍

AlipayCreateOrderPagePayRequest☍

1
2
3
4
5
6
{
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
字段名 类型 描述 是否必填
orderNo string 自定义订单号 是
amount number 订单金额。例如：0.01 是
subject string 商品名称 是
returnUrl string 支付完成后返回的URL地址 否

AlipayCreateOrderRequest☍

1
2
3
4
5
6
{
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
字段名 类型 描述 是否必填
orderNo string 自定义订单号 是
amount number 订单金额。例如：0.01 是
subject string 商品名称 是
returnUrl string 支付完成后返回的URL地址 否

AlipayCreateOrderWapPayRequest☍

1
2
3
4
5
6
{
    "orderNo": ""          // 自定义订单号,
    "amount": "0"          // 订单金额。例如：0.01,
    "subject": ""          // 商品名称,
    "returnUrl": ""          // 支付完成后返回的URL地址
}
字段名 类型 描述 是否必填
orderNo string 自定义订单号 是
amount number 订单金额。例如：0.01 是
subject string 商品名称 是
returnUrl string 支付完成后返回的URL地址 否

AlipayTradeQueryResponse☍

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
{
    "code": "",
    "msg": "",
    "subCode": "",
    "subMsg": "",
    "isError": false,
    "additionalStatus": "",
    "alipayStoreId": "",
    "alipaySubMerchantId": "",
    "asyncPayApplyStatus": "",
    "authTradePayMode": "",
    "bizSettleMode": "",
    "bkagentRespInfo": {
    "bindclrissrId": "",
    "bindpyeracctbkId": "",
    "bindtrxId": "",
    "bkpyeruserCode": "",
    "estterLocation": ""
},
    "body": "",
    "buyerLogonId": "",
    "buyerOpenId": "",
    "buyerPayAmount": "",
    "buyerUserId": "",
    "buyerUserName": "",
    "buyerUserType": "",
    "cashierType": "",
    "chargeAmount": "",
    "chargeFlags": "",
    "chargeInfoList": [
      {
          "chargeFee": "",
          "chargeType": "",
          "isRatingOnSwitch": "",
          "isRatingOnTradeReceiver": "",
          "originalChargeFee": "",
          "subFeeDetailList": [
            {
                "chargeFee": "",
                "originalChargeFee": "",
                "switchFeeRate": ""
            }
          ],
          "switchFeeRate": ""
      }
    ],
    "creditBizOrderId": "",
    "creditPayMode": "",
    "discountAmount": "",
    "discountGoodsDetail": "",
    "enterprisePayInfo": {
    "bizInfo": "",
    "invoiceAmount": "",
    "isUseEnterprisePay": false
},
    "extInfos": "",
    "fulfillmentDetailList": [
      {
          "fulfillmentAmount": "",
          "gmtPayment": "",
          "outRequestNo": ""
      }
    ],
    "fundBillList": [
      {
          "amount": "",
          "bankCode": "",
          "fundChannel": "",
          "fundType": "",
          "realAmount": ""
      }
    ],
    "hbFqPayInfo": {
    "fqAmount": "",
    "userInstallNum": ""
},
    "hybAmount": "",
    "industrySepcDetail": "",
    "industrySepcDetailAcc": "",
    "industrySepcDetailGov": "",
    "intactChargeInfoList": [
      {
          "actualAmount": "",
          "billType": "",
          "gmtPay": "",
          "isRefund": false,
          "outBizNo": "",
          "planAmount": "",
          "productName": "",
          "serviceTarget": "",
          "serviceType": "",
          "status": "",
          "targetAccountNo": "",
          "targetUserId": ""
      }
    ],
    "invoiceAmount": "",
    "mdiscountAmount": "",
    "medicalInsuranceInfo": "",
    "openId": "",
    "outTradeNo": "",
    "passbackParams": "",
    "payAmount": "",
    "payCurrency": "",
    "paymentInfoWithIdList": [
      {
          "paymentIds": [],
          "type": ""
      }
    ],
    "periodScene": "",
    "pointAmount": "",
    "preAuthPayAmount": "",
    "receiptAmount": "",
    "receiptCurrencyType": "",
    "reqGoodsDetail": [
      {
          "alipayGoodsId": "",
          "body": "",
          "categoriesTree": "",
          "goodsCategory": "",
          "goodsId": "",
          "goodsName": "",
          "outItemId": "",
          "outSkuId": "",
          "price": "",
          "quantity": "0",
          "showUrl": ""
      }
    ],
    "sendPayDate": "",
    "settleAmount": "",
    "settleCurrency": "",
    "settleTransRate": "",
    "settlementId": "",
    "storeId": "",
    "storeName": "",
    "subject": "",
    "tapPayInfo": {
    "paymentMediumType": ""
},
    "terminalId": "",
    "totalAmount": "",
    "tradeNo": "",
    "tradeSettleInfo": {
    "tradeSettleDetailList": [
      {
          "amount": "",
          "operationDt": "",
          "operationSerialNo": "",
          "operationType": "",
          "oriTransIn": "",
          "oriTransOut": "",
          "transIn": "",
          "transOut": ""
      }
    ],
    "tradeUnsettledAmount": ""
},
    "tradeStatus": "",
    "transCurrency": "",
    "transPayRate": "",
    "voucherDetailList": [
      {
          "amount": "",
          "id": "",
          "memo": "",
          "merchantContribute": "",
          "name": "",
          "otherContribute": "",
          "otherContributeDetail": [
            {
                "contributeAmount": "",
                "contributeType": ""
            }
          ],
          "purchaseAntContribute": "",
          "purchaseBuyerContribute": "",
          "purchaseMerchantContribute": "",
          "templateId": "",
          "type": ""
      }
    ]
}
字段名 类型 描述 是否必填
code string - 否
msg string - 否
subCode string - 否
subMsg string - 否
isError boolean - 否
additionalStatus string - 否
alipayStoreId string - 否
alipaySubMerchantId string - 否
asyncPayApplyStatus string - 否
authTradePayMode string - 否
bizSettleMode string - 否
bkagentRespInfo - - 否
body string - 否
buyerLogonId string - 否
buyerOpenId string - 否
buyerPayAmount string - 否
buyerUserId string - 否
buyerUserName string - 否
buyerUserType string - 否
cashierType string - 否
chargeAmount string - 否
chargeFlags string - 否
chargeInfoList array - 否
creditBizOrderId string - 否
creditPayMode string - 否
discountAmount string - 否
discountGoodsDetail string - 否
enterprisePayInfo - - 否
extInfos string - 否
fulfillmentDetailList array - 否
fundBillList array - 否
hbFqPayInfo - - 否
hybAmount string - 否
industrySepcDetail string - 否
industrySepcDetailAcc string - 否
industrySepcDetailGov string - 否
intactChargeInfoList array - 否
invoiceAmount string - 否
mdiscountAmount string - 否
medicalInsuranceInfo string - 否
openId string - 否
outTradeNo string - 否
passbackParams string - 否
payAmount string - 否
payCurrency string - 否
paymentInfoWithIdList array - 否
periodScene string - 否
pointAmount string - 否
preAuthPayAmount string - 否
receiptAmount string - 否
receiptCurrencyType string - 否
reqGoodsDetail array - 否
sendPayDate string - 否
settleAmount string - 否
settleCurrency string - 否
settleTransRate string - 否
settlementId string - 否
storeId string - 否
storeName string - 否
subject string - 否
tapPayInfo - - 否
terminalId string - 否
totalAmount string - 否
tradeNo string - 否
tradeSettleInfo - - 否
tradeStatus string - 否
transCurrency string - 否
transPayRate string - 否
voucherDetailList array - 否

AlipayTradeQueryResponseApiResponse☍

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
{
    "code": 200          // 状态码,
    "data": {
    "code": "",
    "msg": "",
    "subCode": "",
    "subMsg": "",
    "isError": false,
    "additionalStatus": "",
    "alipayStoreId": "",
    "alipaySubMerchantId": "",
    "asyncPayApplyStatus": "",
    "authTradePayMode": "",
    "bizSettleMode": "",
    "bkagentRespInfo": {
    "bindclrissrId": "",
    "bindpyeracctbkId": "",
    "bindtrxId": "",
    "bkpyeruserCode": "",
    "estterLocation": ""
},
    "body": "",
    "buyerLogonId": "",
    "buyerOpenId": "",
    "buyerPayAmount": "",
    "buyerUserId": "",
    "buyerUserName": "",
    "buyerUserType": "",
    "cashierType": "",
    "chargeAmount": "",
    "chargeFlags": "",
    "chargeInfoList": [
      {
          "chargeFee": "",
          "chargeType": "",
          "isRatingOnSwitch": "",
          "isRatingOnTradeReceiver": "",
          "originalChargeFee": "",
          "subFeeDetailList": [
            {
                "chargeFee": "",
                "originalChargeFee": "",
                "switchFeeRate": ""
            }
          ],
          "switchFeeRate": ""
      }
    ],
    "creditBizOrderId": "",
    "creditPayMode": "",
    "discountAmount": "",
    "discountGoodsDetail": "",
    "enterprisePayInfo": {
    "bizInfo": "",
    "invoiceAmount": "",
    "isUseEnterprisePay": false
},
    "extInfos": "",
    "fulfillmentDetailList": [
      {
          "fulfillmentAmount": "",
          "gmtPayment": "",
          "outRequestNo": ""
      }
    ],
    "fundBillList": [
      {
          "amount": "",
          "bankCode": "",
          "fundChannel": "",
          "fundType": "",
          "realAmount": ""
      }
    ],
    "hbFqPayInfo": {
    "fqAmount": "",
    "userInstallNum": ""
},
    "hybAmount": "",
    "industrySepcDetail": "",
    "industrySepcDetailAcc": "",
    "industrySepcDetailGov": "",
    "intactChargeInfoList": [
      {
          "actualAmount": "",
          "billType": "",
          "gmtPay": "",
          "isRefund": false,
          "outBizNo": "",
          "planAmount": "",
          "productName": "",
          "serviceTarget": "",
          "serviceType": "",
          "status": "",
          "targetAccountNo": "",
          "targetUserId": ""
      }
    ],
    "invoiceAmount": "",
    "mdiscountAmount": "",
    "medicalInsuranceInfo": "",
    "openId": "",
    "outTradeNo": "",
    "passbackParams": "",
    "payAmount": "",
    "payCurrency": "",
    "paymentInfoWithIdList": [
      {
          "paymentIds": [],
          "type": ""
      }
    ],
    "periodScene": "",
    "pointAmount": "",
    "preAuthPayAmount": "",
    "receiptAmount": "",
    "receiptCurrencyType": "",
    "reqGoodsDetail": [
      {
          "alipayGoodsId": "",
          "body": "",
          "categoriesTree": "",
          "goodsCategory": "",
          "goodsId": "",
          "goodsName": "",
          "outItemId": "",
          "outSkuId": "",
          "price": "",
          "quantity": "0",
          "showUrl": ""
      }
    ],
    "sendPayDate": "",
    "settleAmount": "",
    "settleCurrency": "",
    "settleTransRate": "",
    "settlementId": "",
    "storeId": "",
    "storeName": "",
    "subject": "",
    "tapPayInfo": {
    "paymentMediumType": ""
},
    "terminalId": "",
    "totalAmount": "",
    "tradeNo": "",
    "tradeSettleInfo": {
    "tradeSettleDetailList": [
      {
          "amount": "",
          "operationDt": "",
          "operationSerialNo": "",
          "operationType": "",
          "oriTransIn": "",
          "oriTransOut": "",
          "transIn": "",
          "transOut": ""
      }
    ],
    "tradeUnsettledAmount": ""
},
    "tradeStatus": "",
    "transCurrency": "",
    "transPayRate": "",
    "voucherDetailList": [
      {
          "amount": "",
          "id": "",
          "memo": "",
          "merchantContribute": "",
          "name": "",
          "otherContribute": "",
          "otherContributeDetail": [
            {
                "contributeAmount": "",
                "contributeType": ""
            }
          ],
          "purchaseAntContribute": "",
          "purchaseBuyerContribute": "",
          "purchaseMerchantContribute": "",
          "templateId": "",
          "type": ""
      }
    ]
},
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data - - 否
error string 错误信息 否

AlipayTradeRefundResponse☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
{
    "code": "",
    "msg": "",
    "subCode": "",
    "subMsg": "",
    "body": "",
    "isError": false,
    "buyerLogonId": "",
    "buyerOpenId": "",
    "buyerUserId": "",
    "fundChange": "",
    "gmtRefundPay": "",
    "hasDepositBack": "",
    "openId": "",
    "outTradeNo": "",
    "preAuthCancelFee": "",
    "presentRefundBuyerAmount": "",
    "presentRefundDiscountAmount": "",
    "presentRefundMdiscountAmount": "",
    "refundChargeAmount": "",
    "refundChargeInfoList": [
      {
          "chargeType": "",
          "refundChargeFee": "",
          "refundSubFeeDetailList": [
            {
                "refundChargeFee": "",
                "switchFeeRate": ""
            }
          ],
          "switchFeeRate": ""
      }
    ],
    "refundCurrency": "",
    "refundDetailItemList": [
      {
          "amount": "",
          "bankCode": "",
          "fundChannel": "",
          "fundType": "",
          "realAmount": ""
      }
    ],
    "refundFee": "",
    "refundHybAmount": "",
    "refundPresetPaytoolList": {
    "amount": [],
    "assertTypeCode": ""
},
    "refundSettlementId": "",
    "refundVoucherDetailList": [
      {
          "amount": "",
          "id": "",
          "memo": "",
          "merchantContribute": "",
          "name": "",
          "otherContribute": "",
          "otherContributeDetail": [
            {
                "contributeAmount": "",
                "contributeType": ""
            }
          ],
          "purchaseAntContribute": "",
          "purchaseBuyerContribute": "",
          "purchaseMerchantContribute": "",
          "templateId": "",
          "type": ""
      }
    ],
    "sendBackFee": "",
    "storeName": "",
    "tradeNo": ""
}
字段名 类型 描述 是否必填
code string - 否
msg string - 否
subCode string - 否
subMsg string - 否
body string - 否
isError boolean - 否
buyerLogonId string - 否
buyerOpenId string - 否
buyerUserId string - 否
fundChange string - 否
gmtRefundPay string - 否
hasDepositBack string - 否
openId string - 否
outTradeNo string - 否
preAuthCancelFee string - 否
presentRefundBuyerAmount string - 否
presentRefundDiscountAmount string - 否
presentRefundMdiscountAmount string - 否
refundChargeAmount string - 否
refundChargeInfoList array - 否
refundCurrency string - 否
refundDetailItemList array - 否
refundFee string - 否
refundHybAmount string - 否
refundPresetPaytoolList - - 否
refundSettlementId string - 否
refundVoucherDetailList array - 否
sendBackFee string - 否
storeName string - 否
tradeNo string - 否

AlipayTradeRefundResponseApiResponse☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
{
    "code": 200          // 状态码,
    "data": {
    "code": "",
    "msg": "",
    "subCode": "",
    "subMsg": "",
    "body": "",
    "isError": false,
    "buyerLogonId": "",
    "buyerOpenId": "",
    "buyerUserId": "",
    "fundChange": "",
    "gmtRefundPay": "",
    "hasDepositBack": "",
    "openId": "",
    "outTradeNo": "",
    "preAuthCancelFee": "",
    "presentRefundBuyerAmount": "",
    "presentRefundDiscountAmount": "",
    "presentRefundMdiscountAmount": "",
    "refundChargeAmount": "",
    "refundChargeInfoList": [
      {
          "chargeType": "",
          "refundChargeFee": "",
          "refundSubFeeDetailList": [
            {
                "refundChargeFee": "",
                "switchFeeRate": ""
            }
          ],
          "switchFeeRate": ""
      }
    ],
    "refundCurrency": "",
    "refundDetailItemList": [
      {
          "amount": "",
          "bankCode": "",
          "fundChannel": "",
          "fundType": "",
          "realAmount": ""
      }
    ],
    "refundFee": "",
    "refundHybAmount": "",
    "refundPresetPaytoolList": {
    "amount": [],
    "assertTypeCode": ""
},
    "refundSettlementId": "",
    "refundVoucherDetailList": [
      {
          "amount": "",
          "id": "",
          "memo": "",
          "merchantContribute": "",
          "name": "",
          "otherContribute": "",
          "otherContributeDetail": [
            {
                "contributeAmount": "",
                "contributeType": ""
            }
          ],
          "purchaseAntContribute": "",
          "purchaseBuyerContribute": "",
          "purchaseMerchantContribute": "",
          "templateId": "",
          "type": ""
      }
    ],
    "sendBackFee": "",
    "storeName": "",
    "tradeNo": ""
},
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data - - 否
error string 错误信息 否

BkAgentRespInfo☍

1
2
3
4
5
6
7
{
    "bindclrissrId": "",
    "bindpyeracctbkId": "",
    "bindtrxId": "",
    "bkpyeruserCode": "",
    "estterLocation": ""
}
字段名 类型 描述 是否必填
bindclrissrId string - 否
bindpyeracctbkId string - 否
bindtrxId string - 否
bkpyeruserCode string - 否
estterLocation string - 否

BooleanApiResponse☍

1
2
3
4
5
{
    "code": 200          // 状态码,
    "data": false          // 响应数据,
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data boolean 响应数据 否
error string 错误信息 否

ChargeInfo☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
    "chargeFee": "",
    "chargeType": "",
    "isRatingOnSwitch": "",
    "isRatingOnTradeReceiver": "",
    "originalChargeFee": "",
    "subFeeDetailList": [
      {
          "chargeFee": "",
          "originalChargeFee": "",
          "switchFeeRate": ""
      }
    ],
    "switchFeeRate": ""
}
字段名 类型 描述 是否必填
chargeFee string - 否
chargeType string - 否
isRatingOnSwitch string - 否
isRatingOnTradeReceiver string - 否
originalChargeFee string - 否
subFeeDetailList array - 否
switchFeeRate string - 否

ContributeDetail☍

1
2
3
4
{
    "contributeAmount": "",
    "contributeType": ""
}
字段名 类型 描述 是否必填
contributeAmount string - 否
contributeType string - 否

EnterprisePayInfo☍

1
2
3
4
5
{
    "bizInfo": "",
    "invoiceAmount": "",
    "isUseEnterprisePay": false
}
字段名 类型 描述 是否必填
bizInfo string - 否
invoiceAmount string - 否
isUseEnterprisePay boolean - 否

FulfillmentDetail☍

1
2
3
4
5
{
    "fulfillmentAmount": "",
    "gmtPayment": "",
    "outRequestNo": ""
}
字段名 类型 描述 是否必填
fulfillmentAmount string - 否
gmtPayment string - 否
outRequestNo string - 否

GoodsDetail☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
    "alipayGoodsId": "",
    "body": "",
    "categoriesTree": "",
    "goodsCategory": "",
    "goodsId": "",
    "goodsName": "",
    "outItemId": "",
    "outSkuId": "",
    "price": "",
    "quantity": "0",
    "showUrl": ""
}
字段名 类型 描述 是否必填
alipayGoodsId string - 否
body string - 否
categoriesTree string - 否
goodsCategory string - 否
goodsId string - 否
goodsName string - 否
outItemId string - 否
outSkuId string - 否
price string - 否
quantity integer - 否
showUrl string - 否

HbFqPayInfo☍

1
2
3
4
{
    "fqAmount": "",
    "userInstallNum": ""
}
字段名 类型 描述 是否必填
fqAmount string - 否
userInstallNum string - 否

IntactChargeInfo☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
    "actualAmount": "",
    "billType": "",
    "gmtPay": "",
    "isRefund": false,
    "outBizNo": "",
    "planAmount": "",
    "productName": "",
    "serviceTarget": "",
    "serviceType": "",
    "status": "",
    "targetAccountNo": "",
    "targetUserId": ""
}
字段名 类型 描述 是否必填
actualAmount string - 否
billType string - 否
gmtPay string - 否
isRefund boolean - 否
outBizNo string - 否
planAmount string - 否
productName string - 否
serviceTarget string - 否
serviceType string - 否
status string - 否
targetAccountNo string - 否
targetUserId string - 否

PaymentInfoWithId☍

1
2
3
4
{
    "paymentIds": [],
    "type": ""
}
字段名 类型 描述 是否必填
paymentIds array - 否
type string - 否

PresetPayToolInfo☍

1
2
3
4
{
    "amount": [],
    "assertTypeCode": ""
}
字段名 类型 描述 是否必填
amount array - 否
assertTypeCode string - 否

RefundChargeInfo☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
    "chargeType": "",
    "refundChargeFee": "",
    "refundSubFeeDetailList": [
      {
          "refundChargeFee": "",
          "switchFeeRate": ""
      }
    ],
    "switchFeeRate": ""
}
字段名 类型 描述 是否必填
chargeType string - 否
refundChargeFee string - 否
refundSubFeeDetailList array - 否
switchFeeRate string - 否

RefundSubFee☍

1
2
3
4
{
    "refundChargeFee": "",
    "switchFeeRate": ""
}
字段名 类型 描述 是否必填
refundChargeFee string - 否
switchFeeRate string - 否

ReturnPageNotifyRequest☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
    "app_id": ""          // 应用ID,
    "auth_app_id": ""          // 授权应用ID,
    "charset": ""          // 字符集,
    "method": ""          // 接口名称,
    "out_trade_no": ""          // 商户订单号,
    "seller_id": ""          // 卖家支付宝用户号,
    "sign": ""          // 签名,
    "sign_type": ""          // 签名类型,
    "timestamp": ""          // 时间戳,
    "total_amount": ""          // 订单总金额,
    "trade_no": ""          // 支付宝交易号,
    "version": ""          // 接口版本
}
字段名 类型 描述 是否必填
app_id string 应用ID 否
auth_app_id string 授权应用ID 否
charset string 字符集 否
method string 接口名称 否
out_trade_no string 商户订单号 否
seller_id string 卖家支付宝用户号 否
sign string 签名 否
sign_type string 签名类型 否
timestamp string 时间戳 否
total_amount string 订单总金额 否
trade_no string 支付宝交易号 否
version string 接口版本 否

StringApiResponse☍

1
2
3
4
5
{
    "code": 200          // 状态码,
    "data": ""          // 响应数据,
    "error": ""          // 错误信息
}
字段名 类型 描述 是否必填
code integer 状态码 否
data string 响应数据 否
error string 错误信息 否

SubFee☍

1
2
3
4
5
{
    "chargeFee": "",
    "originalChargeFee": "",
    "switchFeeRate": ""
}
字段名 类型 描述 是否必填
chargeFee string - 否
originalChargeFee string - 否
switchFeeRate string - 否

TapPayInfo☍

1
2
3
{
    "paymentMediumType": ""
}
字段名 类型 描述 是否必填
paymentMediumType string - 否

TradeFundBill☍

1
2
3
4
5
6
7
{
    "amount": "",
    "bankCode": "",
    "fundChannel": "",
    "fundType": "",
    "realAmount": ""
}
字段名 类型 描述 是否必填
amount string - 否
bankCode string - 否
fundChannel string - 否
fundType string - 否
realAmount string - 否

TradeSettleDetail☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
    "amount": "",
    "operationDt": "",
    "operationSerialNo": "",
    "operationType": "",
    "oriTransIn": "",
    "oriTransOut": "",
    "transIn": "",
    "transOut": ""
}
字段名 类型 描述 是否必填
amount string - 否
operationDt string - 否
operationSerialNo string - 否
operationType string - 否
oriTransIn string - 否
oriTransOut string - 否
transIn string - 否
transOut string - 否

TradeSettleInfo☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
    "tradeSettleDetailList": [
      {
          "amount": "",
          "operationDt": "",
          "operationSerialNo": "",
          "operationType": "",
          "oriTransIn": "",
          "oriTransOut": "",
          "transIn": "",
          "transOut": ""
      }
    ],
    "tradeUnsettledAmount": ""
}
字段名 类型 描述 是否必填
tradeSettleDetailList array - 否
tradeUnsettledAmount string - 否

VoucherDetail☍

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
    "amount": "",
    "id": "",
    "memo": "",
    "merchantContribute": "",
    "name": "",
    "otherContribute": "",
    "otherContributeDetail": [
      {
          "contributeAmount": "",
          "contributeType": ""
      }
    ],
    "purchaseAntContribute": "",
    "purchaseBuyerContribute": "",
    "purchaseMerchantContribute": "",
    "templateId": "",
    "type": ""
}
字段名 类型 描述 是否必填
amount string - 否
id string - 否
memo string - 否
merchantContribute string - 否
name string - 否
otherContribute string - 否
otherContributeDetail array - 否
purchaseAntContribute string - 否
purchaseBuyerContribute string - 否
purchaseMerchantContribute string - 否
templateId string - 否
type string - 否

通用错误码☍

错误码 说明
200 成功