Merchant's Exchange Rate

Request

Basic

URL API:

https://a.mypaynz.com/rate/forex_rate

1. Request method: POST
2. Parameter method: Form URL-Encoded
3. Set Content-Type: 'Content-Type: application/x-www-form-urlencoded;charset=utf-8'

API Request Limiation

Same IP 60 times per hour.

TIP

1. The interface exchange rate is for reference only, the actual payment rate is subject to the time of payment.
2. The interface data is not updated frequently, and developers should cache the data on their own servers.

Parameter

Parameter	Type	Nullable	Parameter Description
mid	int(4)	No	Merchant ID
sign	string(32)	No	Signature, please refer to signature explaination section

Examples

• Curl
• PHP
• Golang
• JavaScript
• Java

## Query Rate
curl -X "POST" "https://a.mypaynz.com/rate/forex_rate" \
     -H 'Content-Type: application/x-www-form-urlencoded;charset=utf-8' \
     -H 'Cookie: ci_session=msasjhcraj1k6682htouhm5ra2rt7685' \
     --data-urlencode "mid=10224" \
     --data-urlencode "sign=ac05fe25fcc7de8b53d38d0246ac0e0a"

<?php

// get cURL resource
$ch = curl_init();

// set url
curl_setopt($ch, CURLOPT_URL, 'https://a.mypaynz.com/rate/forex_rate');

// set method
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');

// return the transfer as a string
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// set headers
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Content-Type: application/x-www-form-urlencoded;charset=utf-8',
  'Cookie: ci_session=msasjhcraj1k6682htouhm5ra2rt7685',
]);

// form body
$body = [
  'mid' => '10224',
  'sign' => 'ac05fe25fcc7de8b53d38d0246ac0e0a',
];
$body = http_build_query($body);

// set body
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);

// send the request and save response to $response
$response = curl_exec($ch);

// stop if fails
if (!$response) {
  die('Error: "' . curl_error($ch) . '" - Code: ' . curl_errno($ch));
}

echo 'HTTP Status Code: ' . curl_getinfo($ch, CURLINFO_HTTP_CODE) . PHP_EOL;
echo 'Response Body: ' . $response . PHP_EOL;

// close curl resource to free up system resources
curl_close($ch);

package main

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

func sendQueryRate() {
	// Query Rate (POST https://a.mypaynz.com/rate/forex_rate)

	params := url.Values{}
	params.Set("mid", "10224")
	params.Set("sign", "ac05fe25fcc7de8b53d38d0246ac0e0a")
	body := bytes.NewBufferString(params.Encode())

	// Create client
	client := &http.Client{}

	// Create request
	req, err := http.NewRequest("POST", "https://a.mypaynz.com/rate/forex_rate", body)

	// Headers
	req.Header.Add("Content-Type", "application/x-www-form-urlencoded;charset=utf-8")
	req.Header.Add("Cookie", "ci_session=msasjhcraj1k6682htouhm5ra2rt7685")

	// Fetch Request
	resp, err := client.Do(req)

	if err != nil {
		fmt.Println("Failure : ", err)
	}

	// Read Response Body
	respBody, _ := ioutil.ReadAll(resp.Body)

	// Display Results
	fmt.Println("response Status : ", resp.Status)
	fmt.Println("response Headers : ", resp.Header)
	fmt.Println("response Body : ", string(respBody))
}

axios({
	"method": "POST",
	"url": "https://a.mypaynz.com/rate/forex_rate",
	"headers": {
		"Content-Type": "application/x-www-form-urlencoded;charset=utf-8",
		"Cookie": "ci_session=msasjhcraj1k6682htouhm5ra2rt7685"
	},
	"data": "mid=10224&sign=ac05fe25fcc7de8b53d38d0246ac0e0a"
})

import java.io.IOException;
import org.apache.http.client.fluent.*;
import org.apache.http.entity.ContentType;

public class SendRequest
{
  public static void main(String[] args) {
    sendRequest();
  }

  private static void sendRequest() {

    // Query Rate (POST )

    try {

      // Create request
      Content content = Request.Post("https://a.mypaynz.com/rate/forex_rate")

      // Add headers
      .addHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8")
      .addHeader("Cookie", "ci_session=msasjhcraj1k6682htouhm5ra2rt7685")

      // Add body
      .bodyForm(Form.form()
      .add("mid", "10224")
      .add("sign", "ac05fe25fcc7de8b53d38d0246ac0e0a")
      .build())

      // Fetch request and return content
      .execute().returnContent();

      // Print content
      System.out.println(content);
    }
    catch (IOException e) { System.out.println(e); }
  }
}

Response

Successes

{
  "code": "200",
  "msg": "SUCCESS",
  "data": {
    "currency": "NZD",
    "alipay": {
      "rate": 4.732188
    },
    "wechat": {
      "rate": 4.734636
    }
  },
  "timestamp": 1606712986
}

Error

Signature Error

{
    'is_success':'FALSE'
    'message': 'SIGN_ERROR'
}

Other Error

{
    'is_success':'FALSE'
    'message': 'COMBINE_ERROR'
}

Common Exchange Rate API (soon to be deprecate)

Request

Basic

URL API:

https://a.mypaynz.com/rate/query_rate

1. Request method: GET

API Request Limiation

Same IP 60 times per hour.

TIP

1. The interface exchange rate is for reference only, the actual payment rate is subject to the time of payment.
2. The interface data is not updated frequently, and developers should cache the data on their own servers.

Examples

• Curl
• PHP
• Golang
• JavaScript
• Java

## Query Rate
curl "https://a.mypaynz.com/rate/query_rate" \
     -H 'Cookie: ci_session=msasjhcraj1k6682htouhm5ra2rt7685'

<?php

// get cURL resource
$ch = curl_init();

// set url
curl_setopt($ch, CURLOPT_URL, 'https://a.mypaynz.com/rate/query_rate');

// set method
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

// return the transfer as a string
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// set headers
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Cookie: ci_session=msasjhcraj1k6682htouhm5ra2rt7685',
]);

// send the request and save response to $response
$response = curl_exec($ch);

// stop if fails
if (!$response) {
  die('Error: "' . curl_error($ch) . '" - Code: ' . curl_errno($ch));
}

echo 'HTTP Status Code: ' . curl_getinfo($ch, CURLINFO_HTTP_CODE) . PHP_EOL;
echo 'Response Body: ' . $response . PHP_EOL;

// close curl resource to free up system resources
curl_close($ch);

package main

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

func sendQueryRate() {
	// Query Rate (GET https://a.mypaynz.com/rate/query_rate)

	// Create client
	client := &http.Client{}

	// Create request
	req, err := http.NewRequest("GET", "https://a.mypaynz.com/rate/query_rate", nil)

	// Headers
	req.Header.Add("Cookie", "ci_session=msasjhcraj1k6682htouhm5ra2rt7685")

	// Fetch Request
	resp, err := client.Do(req)

	if err != nil {
		fmt.Println("Failure : ", err)
	}

	// Read Response Body
	respBody, _ := ioutil.ReadAll(resp.Body)

	// Display Results
	fmt.Println("response Status : ", resp.Status)
	fmt.Println("response Headers : ", resp.Header)
	fmt.Println("response Body : ", string(respBody))
}

axios({
	"method": "GET",
	"url": "https://a.mypaynz.com/rate/query_rate",
	"headers": {
		"Cookie": "ci_session=msasjhcraj1k6682htouhm5ra2rt7685"
	}
})

import java.io.IOException;
import org.apache.http.client.fluent.*;

public class SendRequest
{
  public static void main(String[] args) {
    sendRequest();
  }

  private static void sendRequest() {

    // Query Rate (GET )

    try {

      // Create request
      Content content = Request.Get("https://a.mypaynz.com/rate/query_rate")

      // Add headers
      .addHeader("Cookie", "ci_session=msasjhcraj1k6682htouhm5ra2rt7685")

      // Fetch request and return content
      .execute().returnContent();

      // Print content
      System.out.println(content);
    }
    catch (IOException e) { System.out.println(e); }
  }
}

Response

Successes

{
  "is_success": "TRUE",
  "message": "QUERY RATE",
  "extra": [
    {
      "id": "265662",
      "type": "alipay",
      "currency": "NZD",
      "rate": "4.6394",
      "ct": "2020-11-30 12:00:02"
    },
    {
      "id": "265673",
      "type": "wechat",
      "currency": "NZD",
      "rate": "4.6418",
      "ct": "2020-11-30 12:45:02"
    },
    {
      "id": "265663",
      "type": "alipay_web",
      "currency": "NZD",
      "rate": "4.65943",
      "ct": "2020-11-30 12:00:02"
    }
  ]
}