Transaction action

Create a transaction action for future use purposes. Each action lets fraud expert to set reliable balance rules for customers. if affectsBalance is true, the action will affect the customer balance

Path Parameters

idstring

could be order/transfer/cart identified on your end

Header Parameters

x-api-keystring

Request Body

name?string

You can name it.

amountnumber

The amount of transaction

currencystring

ISO 4217 currency code, e.g. USD, EUR, JPY

Lengthlength <= 3

type?string

default is purchase

Default"purchase"

Value in

"purchase" | "refund" | "transfer_in" | "transfer_out" | "topup" | "withdrawal" | "card_payment" | "wallet_payment" | "internal_adjustment" | "fee" | "chargeback" | "reversal" | "credit" | "debit" | "trade_buy" | "trade_sell"

customer?array<object>

Customer identifier on your end

merchant?array<object>

Merchant identifier on your end

Response Body

curl -X POST "https://api.ambriel.io/v1/transactions/:id/actions" \
  -H "x-api-key: string" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "currency": "USD"
  }'

const body = JSON.stringify({
  "amount": 100,
  "currency": "USD"
})

fetch("https://api.ambriel.io/v1/transactions/:id/actions", {
  headers: {
    "x-api-key": "string"
  },
  body
})

package main

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

func main() {
  url := "https://api.ambriel.io/v1/transactions/:id/actions"
  body := strings.NewReader(`{
    "amount": 100,
    "currency": "USD"
  }`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("x-api-key", "string")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

url = "https://api.ambriel.io/v1/transactions/:id/actions"
body = {
  "amount": 100,
  "currency": "USD"
}
response = requests.request("POST", url, json = body, headers = {
  "x-api-key": "string",
  "Content-Type": "application/json"
})

print(response.text)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import java.net.http.HttpRequest.BodyPublishers;

var body = BodyPublishers.ofString("""{
  "amount": 100,
  "currency": "USD"
}""");
HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://api.ambriel.io/v1/transactions/:id/actions"))
  .header("x-api-key", "string")
  .header("Content-Type", "application/json")
  .POST(body)
  .build();

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

using System;
using System.Net.Http;
using System.Text;

var body = new StringContent("""
{
  "amount": 100,
  "currency": "USD"
}
""", Encoding.UTF8, "application/json");

var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "string");
var response = await client.PostAsync("https://api.ambriel.io/v1/transactions/:id/actions", body);
var responseBody = await response.Content.ReadAsStringAsync();

{
  "type": "purchase",
  "name": "Purchase",
  "amount": 100,
  "currency": "USD"
}

Empty

{
  "errors": [
    {
      "message": "The field must be a valid value",
      "rule": "ruleName",
      "field": "phone"
    }
  ]
}