Merge Card PANs

POST {api-url}/mergeCardPANs?ns={community}

Use this endpoint to merge funds from one or more source cards into a single target card. The arrays for CardPANs and Amounts must align. Passing 0 as an amount will transfer the full available balance of that card. The Currency parameter determines which wallet pocket gets merged.

Request

Parameters

Field	Type	Requirement	Description
TargetCardPAN	String	Required	The destination PAN receiving the funds.
CardPANs	String	Required	Comma-separated list of source Card PANs.
Amounts	String	Required	Comma-separated list of amounts in cents to transfer from each source card. Use 0 to transfer the full balance.
Currency	String	Optional	The currency to execute the transfer in. Defaults to the community currency.
Metadata	String	Optional	Any other detail to store with this transaction.

Example Body

{
  "TargetCardPAN": "5007499757700",
  "CardPANs": "5000049941625,5001090055835,5007414135662",
  "Amounts": "2500,5000,7500",
  "Currency": "ZAR",
  "Metadata": ""
}

Response

Parameters

Field	Type	Description
TID	String	TID of the executed operation.
State	String	Transaction state (Success or Failed).
Status	String	Transaction status code (1 or negative error code).
Error	String	Failure reason, if applicable.

Example Body

{
    "TID": "15000000000",
    "State": "Success",
    "Status": "1",
    "Error": ""
}

cURL

curl -X POST '{api-url}/mergeCardPANs?ns={community}' \
-H 'Authorization: bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"TargetCardPAN":"5007499757700","CardPANs":"5000049941625,5001090055835,5007414135662","Amounts":"2500,5000,7500","Currency":"ZAR","Metadata":""}'

C#

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var client = new HttpClient();
        var request = new HttpRequestMessage(HttpMethod.Post, "{api-url}/mergeCardPANs?ns={community}");
        request.Headers.Add("Authorization", "bearer YOUR_TOKEN");

        var jsonPayload = @"{
  ""TargetCardPAN"": ""5007499757700"",
  ""CardPANs"": ""5000049941625,5001090055835,5007414135662"",
  ""Amounts"": ""2500,5000,7500"",
  ""Currency"": ""ZAR"",
  ""Metadata"": """"
}";
        request.Content = new StringContent(jsonPayload, Encoding.UTF8, "application/json");

        var response = await client.SendAsync(request);
        response.EnsureSuccessStatusCode();

        var responseBody = await response.Content.ReadAsStringAsync();
        Console.WriteLine(responseBody);
    }
}

Go

package main

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

func main() {
  url := "{api-url}/mergeCardPANs?ns={community}"
  payload := strings.NewReader(`{"TargetCardPAN":"5007499757700","CardPANs":"5000049941625,5001090055835,5007414135662","Amounts":"2500,5000,7500","Currency":"ZAR","Metadata":""}`)

  req, _ := http.NewRequest("POST", url, payload)
  req.Header.Add("Authorization", "bearer YOUR_TOKEN")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()

  body, _ := ioutil.ReadAll(res.Body)
  fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiRequest {
    public static void main(String[] args) throws Exception {
        var payload = """
                {
  "TargetCardPAN": "5007499757700",
  "CardPANs": "5000049941625,5001090055835,5007414135662",
  "Amounts": "2500,5000,7500",
  "Currency": "ZAR",
  "Metadata": ""
}
                """;

        var request = HttpRequest.newBuilder()
                .uri(URI.create("{api-url}/mergeCardPANs?ns={community}"))
                .header("Authorization", "bearer YOUR_TOKEN")
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(payload))
                .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Node.js

// Requires Node.js v18+
(async () => {
    const url = '{api-url}/mergeCardPANs?ns={community}';
    const payload = {
    "TargetCardPAN": "5007499757700",
    "CardPANs": "5000049941625,5001090055835,5007414135662",
    "Amounts": "2500,5000,7500",
    "Currency": "ZAR",
    "Metadata": ""
};

    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: {
                'Authorization': 'bearer YOUR_TOKEN',
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(payload)
        });
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
})();

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '{api-url}/mergeCardPANs?ns={community}',
  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 => '{
  "TargetCardPAN": "5007499757700",
  "CardPANs": "5000049941625,5001090055835,5007414135662",
  "Amounts": "2500,5000,7500",
  "Currency": "ZAR",
  "Metadata": ""
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: bearer YOUR_TOKEN',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

Python

import requests
import json

url = "{api-url}/mergeCardPANs?ns={community}"
payload = {
  "TargetCardPAN": "5007499757700",
  "CardPANs": "5000049941625,5001090055835,5007414135662",
  "Amounts": "2500,5000,7500",
  "Currency": "ZAR",
  "Metadata": ""
}

headers = {
    "Authorization": "bearer YOUR_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Ruby

require 'uri'
require 'net/http'
require 'json'

url = URI("{api-url}/mergeCardPANs?ns={community}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'bearer YOUR_TOKEN'
request["Content-Type"] = 'application/json'

request.body = JSON.dump({
  "TargetCardPAN": "5007499757700",
  "CardPANs": "5000049941625,5001090055835,5007414135662",
  "Amounts": "2500,5000,7500",
  "Currency": "ZAR",
  "Metadata": ""
})

response = http.request(request)
puts response.read_body