创建交易单

请求信息

请求地址:

https://mypaynz.com/api/v3/payment

1. 请求方式: POST
2. 参数传递方式: Form URL-Encoded
3. 设置Content-Type: 'Content-Type: application/json;X-Requested-With=XMLHttpRequest'

参数详情

参数	类型	是否可空	是否参与签名	参数描述
mid	int(4)	No	Yes	账号的Merchant Id, 通过注册IEPAY (opens new window)获得
amount	int(10)	No	Yes	金额，单位:分
currency	NZD	No	Yes	货币类型 请填: NZD
goods	string(64)	No	Yes	商品名称,请去除特殊符号
goods_detail	string(128)	No	Yes	商品详情,请去除特殊符号
out_trade_no	string(64)	No	Yes	唯一订单号，推荐使用日期+随机数的组合
pay_type	string(8)	No	Yes	支持的支付类型
return_url	string(512)	No	Yes	支付成功后, 页面跳转回的结果地址
notify_url	string(512)	No	Yes	支付成功后, 接收支付结果信息的后台地址
is_mobile	true,false	Yes	No	是否为手机, 仅在支付方位为银联时需要
openid	string(30)	Yes	No	微信的openid, 仅在支付方式为微信小程序时需要
mini_appid	string(20)	Yes	No	微信小程序ID, 仅在支付方式为微信小程序时需要
sign_type	MD5, SHA256	No	No	加密算法类型 签名
sign	string(32)	No	No	签名

代码示例

• Curl
• PHP
• Golang
• JavaScript
• Java

## Create transaction  类似
curl --location --request POST 'https://mypaynz.com/api/v3/payment' \
    --form 'mid="11585"' \
    --form 'amount="1"' \
    --form 'currency="NZD"' \
    --form 'goods="test"' \
    --form 'goods_detail="test 1"' \
    --form 'out_trade_no="20220518012"' \
    --form 'pay_type="IE0012"' \
    --form 'sign="THISJUSTATEST"' \
    --form 'sign_type="MD5"' \
    --form 'return_url="http://test.com/return"' \
    --form 'notify_url="http://test.com/notify"' \

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://mypaynz.com/api/v3/payment',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array(
      'mid' => '11585', 
      'amount' => '1',
      'currency' => 'NZD',
      'goods' => 'test',
      'goods_detail' => 'test 1',
      'out_trade_no' => '20220518012',
      'pay_type' => 'IE0012',
      'sign' => 'THISJUSTATEST',
      'sign_type' => 'MD5',
      'return_url' => 'http://test.com/return',
      'notify_url' => 'http://test.com/notify',
    ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

package main

import (
  "fmt"
  "bytes"
  "mime/multipart"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://mypaynz.com/api/v3/payment"
  method := "POST"

  payload := &bytes.Buffer{}
  writer := multipart.NewWriter(payload)
  _ = writer.WriteField("mid", "11585")
  _ = writer.WriteField("amount", "1")
  _ = writer.WriteField("currency", "NZD")
  _ = writer.WriteField("goods", "test")
  _ = writer.WriteField("goods_detail", "test 1")
  _ = writer.WriteField("out_trade_no", "20220518012")
  _ = writer.WriteField("pay_type", "IE0012")
  _ = writer.WriteField("sign", "THISJUSTATEST")
  _ = writer.WriteField("sign_type", "MD5")
  _ = writer.WriteField("return_url", "http://test.com/return")
  _ = writer.WriteField("notify_url", "http://test.com/notify")
  err := writer.Close()
  if err != nil {
    fmt.Println(err)
    return
  }


  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Set("Content-Type", writer.FormDataContentType())
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var formdata = new FormData();
formdata.append("mid", "11585");
formdata.append("amount", "1");
formdata.append("currency", "NZD");
formdata.append("goods", "test");
formdata.append("goods_detail", "test 1");
formdata.append("out_trade_no", "20220518012");
formdata.append("pay_type", "IE0012");
formdata.append("sign", "THISJUSTATEST");
formdata.append("sign_type", "MD5");
formdata.append("return_url", "http://test.com/return");
formdata.append("notify_url", "http://test.com/notify");

var requestOptions = {
  method: 'POST',
  body: formdata,
  redirect: 'follow'
};

fetch("https://mypaynz.com/api/v3/payment", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://mypaynz.com/api/v3/payment")
  .multiPartContent()
  .field("mid", "11585")
  .field("amount", "1")
  .field("currency", "NZD")
  .field("goods", "test")
  .field("goods_detail", "test 1")
  .field("out_trade_no", "20220518012")
  .field("pay_type", "IE0012")
  .field("sign", "THISJUSTATEST")
  .field("sign_type", "MD5")
  .field("return_url", "http://test.com/return")
  .field("notify_url", "http://test.com/notify")
  .asString();

结果详情

成功

{
    "success": true,
    "status": true,
    "error_code": 0,
    "message": "OK",
    "data": {
        "pay_type": "IE0012",
        "pay_type_str": "Alipay Web",
        "out_trade_no": "20220518012",
        "trade_no": null,
        "amount": 1,
        "status": 0,  //（0: 未支付, 1: 已支付, 2: 结算前退款, 3: 已支付并结算, 4: 结算后退款）
        "status_str": "Unpay",
        "pay_url": "https://alipay.com/payment/url"
    }
}

交易单已创建

{
    "success": false,
    "status": false,
    "error_code": 0,
    "message": "This order alreade exist.",
    "data": {
        "pay_type": "IE0012",
        "pay_type_str": "Alipay Web",
        "out_trade_no": "20220518012",
        "trade_no": null,
        "amount": 1,
        "status": 0,
        "status_str": "Unpay",
        "pay_url": "https://alipay.com/payment/url"
    }
}

错误

签名错误

{
    "success": false,
    "status": false,
    "error_code": 104,
    "message": "The signature is not matched.",
    "data": []
}

缺少参数

{
    "success": false,
    "status": false,
    "error_code": 102,
    "message": "The parameters are invalid.",
    "data": {
        "mid": [
            "The mid field is required."
        ]
    }
}

查询订单

请求信息

请求地址:

https://mypaynz.com/api/v3/query

1. 请求方式: GET
2. 参数传递方式: Form URL-Encoded
3. 设置Content-Type: 'Content-Type: application/json;X-Requested-With=XMLHttpRequest'

参数详情

参数	类型	是否可空	是否参与签名	参数描述
mid	int(4)	No	Yes	账号的Merchant Id, 通过注册IEPAY (opens new window)获得
out_trade_no	string(64)	No	Yes	唯一订单号，推荐使用日期+随机数的组合
sign_type	MD5, SHA256	No	No	加密算法类型 签名
sign	string(32)	No	No	签名

代码示例

• Curl
• PHP
• Golang
• JavaScript
• Java

## Create transaction  类似
curl --location --request GET 'https://mypaynz.com/api/v3/query?mid=11585&out_trade_no=20220518012&sign=THISJUSTATEST&sign_type=MD5' \
--header 'Content-Type: application/json' \
--header 'X-Requested-With: XMLHttpRequest'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://mypaynz.com/api/v3/query?mid=11585&out_trade_no=20220518012&sign=THISJUSTATEST&sign_type=MD5',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'X-Requested-With: XMLHttpRequest'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://mypaynz.com/api/v3/query?mid=11585&out_trade_no=20220518012&sign=THISJUSTATEST&sign_type=MD5"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("X-Requested-With", "XMLHttpRequest")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("X-Requested-With", "XMLHttpRequest");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://mypaynz.com/api/v3/query?mid=11585&out_trade_no=20220518012&sign=THISJUSTATEST&sign_type=MD5", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://mypaynz.com/api/v3/query?mid=11585&out_trade_no=20220518012&sign=THISJUSTATEST&sign_type=MD5")
  .header("Content-Type", "application/json")
  .header("X-Requested-With", "XMLHttpRequest")
  .asString();

结果详情

成功

{
    "success": true,
    "status": true,
    "error_code": 0,
    "message": "OK",
    "data": {
        "pay_type": "IE0012",
        "pay_type_str": "Alipay Web",
        "out_trade_no": "20220518012",
        "trade_no": null,
        "amount": 1,
        "status": 0,    //（0: 未支付, 1: 已支付, 2: 结算前退款, 3: 已支付并结算, 4: 结算后退款）
        "status_str": "Unpay",
        "refunded_amount": 0,
        "pay_url": "https://alipay.com/payment/url"
    }
}

错误

签名错误

{
    "success": false,
    "status": false,
    "error_code": 104,
    "message": "The signature is not matched.",
    "data": []
}

缺少参数

{
    "success": false,
    "status": false,
    "error_code": 102,
    "message": "The parameters are invalid.",
    "data": {
        "mid": [
            "The mid field is required."
        ]
    }
}

退款

请求信息

请求地址:

https://mypaynz.com/api/v3/refund

1. 请求方式: POST
2. 参数传递方式: Form URL-Encoded
3. 设置Content-Type: 'Content-Type: application/json;X-Requested-With=XMLHttpRequest'

参数详情

参数	类型	是否可空	是否参与签名	参数描述
mid	int(4)	No	Yes	账号的Merchant Id, 通过注册IEPAY (opens new window)获得
amount	int(10)	No	Yes	金额，单位:分
out_trade_no	string(64)	No	Yes	唯一订单号，推荐使用日期+随机数的组合
sign_type	MD5, SHA256	No	No	加密算法类型 签名
sign	string(32)	No	No	签名

代码示例

• Curl
• PHP
• Golang
• JavaScript
• Java

## Create transaction  类似
curl --location --request POST 'https://mypaynz.com/api/v3/refund' \
    --form 'mid="11585"' \
    --form 'amount="1"' \
    --form 'out_trade_no="20220518012"' \
    --form 'sign="THISJUSTATEST"' \
    --form 'sign_type="MD5"'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://mypaynz.com/api/v3/refund',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('mid' => '11585','amount' => '1','out_trade_no' => '20220518012','sign' => 'THISJUSTATEST','sign_type' => 'MD5'),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

package main

import (
  "fmt"
  "bytes"
  "mime/multipart"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://mypaynz.com/api/v3/refund"
  method := "POST"

  payload := &bytes.Buffer{}
  writer := multipart.NewWriter(payload)
  _ = writer.WriteField("mid", "11585")
  _ = writer.WriteField("amount", "1")
  _ = writer.WriteField("out_trade_no", "20220518012")
  _ = writer.WriteField("sign", "THISJUSTATEST")
  _ = writer.WriteField("sign_type", "MD5")
  err := writer.Close()
  if err != nil {
    fmt.Println(err)
    return
  }


  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Set("Content-Type", writer.FormDataContentType())
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var formdata = new FormData();
formdata.append("mid", "11585");
formdata.append("amount", "1");
formdata.append("out_trade_no", "20220518012");
formdata.append("sign", "THISJUSTATEST");
formdata.append("sign_type", "MD5");

var requestOptions = {
  method: 'POST',
  body: formdata,
  redirect: 'follow'
};

fetch("https://mypaynz.com/api/v3/refund", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://mypaynz.com/api/v3/refund")
  .multiPartContent()
  .field("mid", "11585")
  .field("amount", "1")
  .field("out_trade_no", "20220518012")
  .field("sign", "THISJUSTATEST")
  .field("sign_type", "MD5")
  .asString();

结果详情

成功

{
    "success": true,
    "status": true,
    "error_code": 0,
    "message": "OK",
    "data": {
        "pay_type": "IE0012",
        "pay_type_str": "Alipay Web",
        "out_trade_no": "20220518012",
        "trade_no": "origin_trade_no",
        "amount": 1,
        "status": 2,      // （0: 未支付, 1: 已支付, 2: 结算前退款, 3: 已支付并结算, 4: 结算后退款）
        "status_str": "Refund",
        "refunded": 1
    }
}

错误

签名错误

{
    "success": false,
    "status": false,
    "error_code": 104,
    "message": "The signature is not matched.",
    "data": []
}

缺少参数

{
    "success": false,
    "status": false,
    "error_code": 102,
    "message": "The parameters are invalid.",
    "data": {
        "mid": [
            "The mid field is required."
        ]
    }
}