curl --request POST \
--url https://int-prodtest.m1amdocs.io/partnersub/v2/transaction \
--header 'Content-Type: */*' \
--header 'X-API-KEY: <api-key>' \
--data '{
"id": "<string>",
"amount": 123,
"items": [
{
"code": "<string>",
"name": "<string>",
"price": 123,
"quantity": 123,
"tax_classification": "<string>",
"total": 123,
"metadata": {}
}
],
"object": "Transaction",
"created": "2023-11-07T05:31:56Z",
"currency": "<string>",
"metadata": {},
"billing_descriptor": "<string>",
"original_billing_date": "2023-11-07T05:31:56Z"
}'import requests
url = "https://int-prodtest.m1amdocs.io/partnersub/v2/transaction"
payload = "{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}"
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "*/*"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': '*/*'},
body: '{\n "id": "<string>",\n "amount": 123,\n "items": [\n {\n "code": "<string>",\n "name": "<string>",\n "price": 123,\n "quantity": 123,\n "tax_classification": "<string>",\n "total": 123,\n "metadata": {}\n }\n ],\n "object": "Transaction",\n "created": "2023-11-07T05:31:56Z",\n "currency": "<string>",\n "metadata": {},\n "billing_descriptor": "<string>",\n "original_billing_date": "2023-11-07T05:31:56Z"\n}'
};
fetch('https://int-prodtest.m1amdocs.io/partnersub/v2/transaction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://int-prodtest.m1amdocs.io/partnersub/v2/transaction",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}",
CURLOPT_HTTPHEADER => [
"Content-Type: */*",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://int-prodtest.m1amdocs.io/partnersub/v2/transaction"
payload := strings.NewReader("{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "*/*")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://int-prodtest.m1amdocs.io/partnersub/v2/transaction")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "*/*")
.body("{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://int-prodtest.m1amdocs.io/partnersub/v2/transaction")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = '*/*'
request.body = "{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "<string>",
"extConfirmationId": "<string>",
"metadata": {}
}{
"code": "invalid-request",
"message": "Invalid request."
}{
"code": "authentication-required",
"message": "<string>"
}{
"code": "forbidden",
"message": "<string>"
}{
"code": "not-found",
"message": "<string>"
}{
"code": "server-error",
"message": "<string>"
}Create a new payment transaction
curl --request POST \
--url https://int-prodtest.m1amdocs.io/partnersub/v2/transaction \
--header 'Content-Type: */*' \
--header 'X-API-KEY: <api-key>' \
--data '{
"id": "<string>",
"amount": 123,
"items": [
{
"code": "<string>",
"name": "<string>",
"price": 123,
"quantity": 123,
"tax_classification": "<string>",
"total": 123,
"metadata": {}
}
],
"object": "Transaction",
"created": "2023-11-07T05:31:56Z",
"currency": "<string>",
"metadata": {},
"billing_descriptor": "<string>",
"original_billing_date": "2023-11-07T05:31:56Z"
}'import requests
url = "https://int-prodtest.m1amdocs.io/partnersub/v2/transaction"
payload = "{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}"
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "*/*"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': '*/*'},
body: '{\n "id": "<string>",\n "amount": 123,\n "items": [\n {\n "code": "<string>",\n "name": "<string>",\n "price": 123,\n "quantity": 123,\n "tax_classification": "<string>",\n "total": 123,\n "metadata": {}\n }\n ],\n "object": "Transaction",\n "created": "2023-11-07T05:31:56Z",\n "currency": "<string>",\n "metadata": {},\n "billing_descriptor": "<string>",\n "original_billing_date": "2023-11-07T05:31:56Z"\n}'
};
fetch('https://int-prodtest.m1amdocs.io/partnersub/v2/transaction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://int-prodtest.m1amdocs.io/partnersub/v2/transaction",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}",
CURLOPT_HTTPHEADER => [
"Content-Type: */*",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://int-prodtest.m1amdocs.io/partnersub/v2/transaction"
payload := strings.NewReader("{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "*/*")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://int-prodtest.m1amdocs.io/partnersub/v2/transaction")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "*/*")
.body("{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://int-prodtest.m1amdocs.io/partnersub/v2/transaction")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = '*/*'
request.body = "{\n \"id\": \"<string>\",\n \"amount\": 123,\n \"items\": [\n {\n \"code\": \"<string>\",\n \"name\": \"<string>\",\n \"price\": 123,\n \"quantity\": 123,\n \"tax_classification\": \"<string>\",\n \"total\": 123,\n \"metadata\": {}\n }\n ],\n \"object\": \"Transaction\",\n \"created\": \"2023-11-07T05:31:56Z\",\n \"currency\": \"<string>\",\n \"metadata\": {},\n \"billing_descriptor\": \"<string>\",\n \"original_billing_date\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "<string>",
"extConfirmationId": "<string>",
"metadata": {}
}{
"code": "invalid-request",
"message": "Invalid request."
}{
"code": "authentication-required",
"message": "<string>"
}{
"code": "forbidden",
"message": "<string>"
}{
"code": "not-found",
"message": "<string>"
}{
"code": "server-error",
"message": "<string>"
}Authorizations
The authorization key obtained from MarketONE.
Headers
The TraceId indicates the overall ID of the trace. Every span in a trace shares this ID. The X-B3-TraceId header is encoded as 32 or 16 lower-hex characters. For example, a 128-bit TraceId header might look like 463ac35c9f6413ad48485a3953bb6124.
The SpanId is 64-bit in length and indicates the position of the current operation in the trace tree. The value should not be interpreted; it may or may not be derived from the value of the TraceId. The X-B3-SpanId header is encoded as 16 lower-hex characters. For example, a SpanId header might look like a2fb4a1d1a96d312. Unless propagating only the Sampling State, the X-B3-SpanId header is required.
The ParentSpanId is 64-bit in length and indicates the position of the parent operation in the trace tree. When the span is the root of the trace tree, there is no ParentSpanId. The X-B3-ParentSpanId header may be present on a child span and must be absent on the root span. It is encoded as 16 lower-hex characters. For example, a ParentSpanId header might look like 0020000000000001.
Body
A new Transaction; required attributes are id, account vid, transaction items for amount and tax as appropriate, product code passed in as 'code' for transaction item, code value as 'TOTAL_TAX' for tax trasanction item.
The Transaction object provides a way to charge a customer.
A unique identifier.
128The net amount of the charge presented by this transaction, as a decimal. Must be positive (zero allowed).
The array of Transaction Items belonging to this transaction. Items correspond to the charges.There will be 2 separate items - One for the actual amount and other for tax amount.
Show child attributes
Show child attributes
Value is “Transaction”
Transaction The time this transaction was initiated.
The Account represents an aggregator’s customer.
Show child attributes
Show child attributes
A set of key/value pairs that you can attach to an object. Useful for storing additional information. For transactions resulting from a subscription, the metadata is also inherited from the subscription.
Show child attributes
Show child attributes
Optional “soft descriptor” to send to the aggregator for this transaction.
The original scheduled billing date associated with the billing for which this transaction collects funds. For an initial attempt, this is the same as the transaction date; for a retry transaction this is the original attempt date.
Response
Successfully created Transaction
The transaction response entity relates to the payment request that can be initiated either by the digital partner in the case of direct carrier billing (BILLING), or the backend billing system of the service provider at the end of every billing cycle.
A unique identifier.
128Status of the transaction once processed (mandatory on the response)
Transaction identifier
36A set of key/value pairs that you can attach to an object. Useful for storing additional information.
Show child attributes
Show child attributes
Was this page helpful?

