Account Center › API Reference › Sandbox

Sandbox: current injected behavior for each business line

GET /v1/sandbox/upstream-behaviors scope: merchant:read

Merchant account

Always returns four business lines (remittance / card / qrpay / chain). Lines without injected behavior show success: the default is normal operation, not Unset.

⚠ Values identify business lines, not individual providers. Which upstreams we use, how many there are, and when we change them are not part of the contract. Inject behavior by business line so your integration scripts need no changes when we change providers.

The displayed behavior is what the next order will actually encounter; see POST /v1/sandbox/upstream-behavior.

Parameters

This endpoint takes no parameters: no path parameters, query parameters or request body. For the authentication header (x-auth-token) and on-behalf-of header (x-on-behalf-of), see Authentication and Signing.

Response

200OK

{
  "data": [
    {
      "upstream": "remittance",
      "behavior": "unknown"
    },
    {
      "upstream": "card",
      "behavior": "success"
    },
    {
      "upstream": "qrpay",
      "behavior": "success"
    },
    {
      "upstream": "chain",
      "behavior": "success"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

404Not in the sandbox environment.

Request

curl -X GET 'https://api.zinfra.vip/v1/sandbox/upstream-behaviors' \
  -H 'x-auth-token: Bearer $TOKEN'

const res = await fetch("https://api.zinfra.vip/v1/sandbox/upstream-behaviors", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
  },
});
// Keep monetary amounts as strings, never numbers.
const data = await res.json();

import requests

res = requests.get(
    "https://api.zinfra.vip/v1/sandbox/upstream-behaviors",
    headers={
        "x-auth-token": "Bearer $TOKEN",
    },
)
# Use Decimal(str(...)) for amounts, not float.
data = res.json()

req, _ := http.NewRequest("GET", "https://api.zinfra.vip/v1/sandbox/upstream-behaviors",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
res, err := http.DefaultClient.Do(req)
// Decode amount fields as string, not float64.

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zinfra.vip/v1/sandbox/upstream-behaviors"))
    .header("x-auth-token", "Bearer $TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// Use String / BigDecimal for amounts, not double.

$ch = curl_init('https://api.zinfra.vip/v1/sandbox/upstream-behaviors');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
  ],
]);
$res = curl_exec($ch);
// Use bcmath / strings for amounts, not floatval.

200

{
  "data": [
    {
      "upstream": "remittance",
      "behavior": "unknown"
    },
    {
      "upstream": "card",
      "behavior": "success"
    },
    {
      "upstream": "qrpay",
      "behavior": "success"
    },
    {
      "upstream": "chain",
      "behavior": "success"
    }
  ],
  "next_cursor": null,
  "has_more": false
}