Update tokenized card data

curl --request POST \
  --url https://api.nomba.com/v1/checkout/tokenized-card-data \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '
{
  "tokenKey": "5844858382",
  "currentEmailAddress": "email@email.com",
  "newEmailAddress": "email@email.com"
}
'

import requests

url = "https://api.nomba.com/v1/checkout/tokenized-card-data"

payload = {
    "tokenKey": "5844858382",
    "currentEmailAddress": "email@email.com",
    "newEmailAddress": "email@email.com"
}
headers = {
    "accountId": "<accountid>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    accountId: '<accountid>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    tokenKey: '5844858382',
    currentEmailAddress: 'email@email.com',
    newEmailAddress: 'email@email.com'
  })
};

fetch('https://api.nomba.com/v1/checkout/tokenized-card-data', 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://api.nomba.com/v1/checkout/tokenized-card-data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tokenKey' => '5844858382',
    'currentEmailAddress' => 'email@email.com',
    'newEmailAddress' => 'email@email.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "accountId: <accountid>"
  ],
]);

$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://api.nomba.com/v1/checkout/tokenized-card-data"

	payload := strings.NewReader("{\n  \"tokenKey\": \"5844858382\",\n  \"currentEmailAddress\": \"email@email.com\",\n  \"newEmailAddress\": \"email@email.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("accountId", "<accountid>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.nomba.com/v1/checkout/tokenized-card-data")
  .header("accountId", "<accountid>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tokenKey\": \"5844858382\",\n  \"currentEmailAddress\": \"email@email.com\",\n  \"newEmailAddress\": \"email@email.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.nomba.com/v1/checkout/tokenized-card-data")

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

request = Net::HTTP::Post.new(url)
request["accountId"] = '<accountid>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tokenKey\": \"5844858382\",\n  \"currentEmailAddress\": \"email@email.com\",\n  \"newEmailAddress\": \"email@email.com\"\n}"

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

{
  "code": "00",
  "description": "Success",
  "data": {
    "status": "true",
    "message": "email@email.com",
    "tokenizedCardData": [
      {
        "tokenKey": "e890bd1a9f0d",
        "customerEmail": "email@email.com",
        "cardType": "Verve",
        "cardPan": "234818********7580",
        "tokenExpirationDate": "20/20"
      }
    ]
  }
}

{
  "code": "400",
  "description": "Request failed."
}

{
  "code": "401",
  "description": "Unauthorized"
}

{
  "code": "403",
  "description": "Forbidden"
}

{
  "code": "404",
  "description": "Record not found"
}

{
  "code": "429",
  "description": "Too many requests"
}

{
  "code": "500",
  "description": "Server error"
}

POST

checkout

tokenized-card-data

Update tokenized card data

curl --request POST \
  --url https://api.nomba.com/v1/checkout/tokenized-card-data \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '
{
  "tokenKey": "5844858382",
  "currentEmailAddress": "email@email.com",
  "newEmailAddress": "email@email.com"
}
'

import requests

url = "https://api.nomba.com/v1/checkout/tokenized-card-data"

payload = {
    "tokenKey": "5844858382",
    "currentEmailAddress": "email@email.com",
    "newEmailAddress": "email@email.com"
}
headers = {
    "accountId": "<accountid>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    accountId: '<accountid>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    tokenKey: '5844858382',
    currentEmailAddress: 'email@email.com',
    newEmailAddress: 'email@email.com'
  })
};

fetch('https://api.nomba.com/v1/checkout/tokenized-card-data', 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://api.nomba.com/v1/checkout/tokenized-card-data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tokenKey' => '5844858382',
    'currentEmailAddress' => 'email@email.com',
    'newEmailAddress' => 'email@email.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "accountId: <accountid>"
  ],
]);

$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://api.nomba.com/v1/checkout/tokenized-card-data"

	payload := strings.NewReader("{\n  \"tokenKey\": \"5844858382\",\n  \"currentEmailAddress\": \"email@email.com\",\n  \"newEmailAddress\": \"email@email.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("accountId", "<accountid>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.nomba.com/v1/checkout/tokenized-card-data")
  .header("accountId", "<accountid>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tokenKey\": \"5844858382\",\n  \"currentEmailAddress\": \"email@email.com\",\n  \"newEmailAddress\": \"email@email.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.nomba.com/v1/checkout/tokenized-card-data")

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

request = Net::HTTP::Post.new(url)
request["accountId"] = '<accountid>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tokenKey\": \"5844858382\",\n  \"currentEmailAddress\": \"email@email.com\",\n  \"newEmailAddress\": \"email@email.com\"\n}"

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

{
  "code": "00",
  "description": "Success",
  "data": {
    "status": "true",
    "message": "email@email.com",
    "tokenizedCardData": [
      {
        "tokenKey": "e890bd1a9f0d",
        "customerEmail": "email@email.com",
        "cardType": "Verve",
        "cardPan": "234818********7580",
        "tokenExpirationDate": "20/20"
      }
    ]
  }
}

{
  "code": "400",
  "description": "Request failed."
}

{
  "code": "401",
  "description": "Unauthorized"
}

{
  "code": "403",
  "description": "Forbidden"
}

{
  "code": "404",
  "description": "Record not found"
}

{
  "code": "429",
  "description": "Too many requests"
}

{
  "code": "500",
  "description": "Server error"
}

For a complete guide on response codes and transaction statuses, see Response Codes.

Authorizations

Authorization

string

header

required

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

accountId

string<uuid>

required

The parent accountId of the business.

Example:

"890022ce-bae0-45c1-9b9d-ee7872e6ca27"

Body

application/json

The request payload required to update the tokenized card data

tokenKey

string

required

token key

Example:

"5844858382"

currentEmailAddress

string

required

customer email currently associated with the key

Example:

"email@email.com"

newEmailAddress

string

required

new email to replace the old one

Example:

"email@email.com"

Response

Data update successful.

code

string

required

Response Code

Example:

"00"

description

string

required

Response description

Example:

"Success"

data

object

required

Show child attributes

API Documentation

Authenticate

Accounts

Virtual Accounts

Online Checkout

Charge

Direct Debits

Transfers

Terminals

Transactions

Requery

Global Payout

DRC Collection

Airtime & Data Vending

Cable & Bill Payments

Betting

Update tokenized card data

Authorizations

Headers

Body

Response