Create a payin
curl --request POST \
--url https://service-sandbox.tazapay.com/v3/payin \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"invoice_currency": "INR",
"amount": 100,
"customer_details": {
"name": "Andrea Lark",
"country": "SG",
"email": "andrea@example.com",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"billing_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"shipping_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"success_url": "https://mystore.com/success_page",
"cancel_url": "https://mystore.com/try_again",
"webhook_url": "https://mystore.com/internal/webhook",
"payment_methods": [
"paynow_sgd",
"card"
],
"transaction_description": "test",
"metadata": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"reference_id": "string",
"confirm": false,
"statement_descriptor": "string",
"payment_method_details": {
"key": "value"
},
"session_id": "test_session_id"
}
'import requests
url = "https://service-sandbox.tazapay.com/v3/payin"
payload = {
"invoice_currency": "INR",
"amount": 100,
"customer_details": {
"name": "Andrea Lark",
"country": "SG",
"email": "andrea@example.com",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"billing_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"shipping_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"success_url": "https://mystore.com/success_page",
"cancel_url": "https://mystore.com/try_again",
"webhook_url": "https://mystore.com/internal/webhook",
"payment_methods": ["paynow_sgd", "card"],
"transaction_description": "test",
"metadata": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"reference_id": "string",
"confirm": False,
"statement_descriptor": "string",
"payment_method_details": { "key": "value" },
"session_id": "test_session_id"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
invoice_currency: 'INR',
amount: 100,
customer_details: {
name: 'Andrea Lark',
country: 'SG',
email: 'andrea@example.com',
phone: {calling_code: '65', number: '87654321'}
},
billing_details: {
address: {
city: 'Singapore',
country: 'SG',
line1: '1st Street',
line2: '2nd Avenue',
postal_code: '43004',
state: 'Singapore'
},
label: 'Home',
name: 'Andrea Lark',
phone: {calling_code: '65', number: '87654321'}
},
shipping_details: {
address: {
city: 'Singapore',
country: 'SG',
line1: '1st Street',
line2: '2nd Avenue',
postal_code: '43004',
state: 'Singapore'
},
label: 'Home',
name: 'Andrea Lark',
phone: {calling_code: '65', number: '87654321'}
},
success_url: 'https://mystore.com/success_page',
cancel_url: 'https://mystore.com/try_again',
webhook_url: 'https://mystore.com/internal/webhook',
payment_methods: ['paynow_sgd', 'card'],
transaction_description: 'test',
metadata: {key1: 'value1', key2: 'value2', key3: 'value3'},
reference_id: 'string',
confirm: false,
statement_descriptor: 'string',
payment_method_details: {key: 'value'},
session_id: 'test_session_id'
})
};
fetch('https://service-sandbox.tazapay.com/v3/payin', 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://service-sandbox.tazapay.com/v3/payin",
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([
'invoice_currency' => 'INR',
'amount' => 100,
'customer_details' => [
'name' => 'Andrea Lark',
'country' => 'SG',
'email' => 'andrea@example.com',
'phone' => [
'calling_code' => '65',
'number' => '87654321'
]
],
'billing_details' => [
'address' => [
'city' => 'Singapore',
'country' => 'SG',
'line1' => '1st Street',
'line2' => '2nd Avenue',
'postal_code' => '43004',
'state' => 'Singapore'
],
'label' => 'Home',
'name' => 'Andrea Lark',
'phone' => [
'calling_code' => '65',
'number' => '87654321'
]
],
'shipping_details' => [
'address' => [
'city' => 'Singapore',
'country' => 'SG',
'line1' => '1st Street',
'line2' => '2nd Avenue',
'postal_code' => '43004',
'state' => 'Singapore'
],
'label' => 'Home',
'name' => 'Andrea Lark',
'phone' => [
'calling_code' => '65',
'number' => '87654321'
]
],
'success_url' => 'https://mystore.com/success_page',
'cancel_url' => 'https://mystore.com/try_again',
'webhook_url' => 'https://mystore.com/internal/webhook',
'payment_methods' => [
'paynow_sgd',
'card'
],
'transaction_description' => 'test',
'metadata' => [
'key1' => 'value1',
'key2' => 'value2',
'key3' => 'value3'
],
'reference_id' => 'string',
'confirm' => false,
'statement_descriptor' => 'string',
'payment_method_details' => [
'key' => 'value'
],
'session_id' => 'test_session_id'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$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://service-sandbox.tazapay.com/v3/payin"
payload := strings.NewReader("{\n \"invoice_currency\": \"INR\",\n \"amount\": 100,\n \"customer_details\": {\n \"name\": \"Andrea Lark\",\n \"country\": \"SG\",\n \"email\": \"andrea@example.com\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"billing_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"shipping_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"success_url\": \"https://mystore.com/success_page\",\n \"cancel_url\": \"https://mystore.com/try_again\",\n \"webhook_url\": \"https://mystore.com/internal/webhook\",\n \"payment_methods\": [\n \"paynow_sgd\",\n \"card\"\n ],\n \"transaction_description\": \"test\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\",\n \"key3\": \"value3\"\n },\n \"reference_id\": \"string\",\n \"confirm\": false,\n \"statement_descriptor\": \"string\",\n \"payment_method_details\": {\n \"key\": \"value\"\n },\n \"session_id\": \"test_session_id\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://service-sandbox.tazapay.com/v3/payin")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"invoice_currency\": \"INR\",\n \"amount\": 100,\n \"customer_details\": {\n \"name\": \"Andrea Lark\",\n \"country\": \"SG\",\n \"email\": \"andrea@example.com\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"billing_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"shipping_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"success_url\": \"https://mystore.com/success_page\",\n \"cancel_url\": \"https://mystore.com/try_again\",\n \"webhook_url\": \"https://mystore.com/internal/webhook\",\n \"payment_methods\": [\n \"paynow_sgd\",\n \"card\"\n ],\n \"transaction_description\": \"test\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\",\n \"key3\": \"value3\"\n },\n \"reference_id\": \"string\",\n \"confirm\": false,\n \"statement_descriptor\": \"string\",\n \"payment_method_details\": {\n \"key\": \"value\"\n },\n \"session_id\": \"test_session_id\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://service-sandbox.tazapay.com/v3/payin")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoice_currency\": \"INR\",\n \"amount\": 100,\n \"customer_details\": {\n \"name\": \"Andrea Lark\",\n \"country\": \"SG\",\n \"email\": \"andrea@example.com\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"billing_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"shipping_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"success_url\": \"https://mystore.com/success_page\",\n \"cancel_url\": \"https://mystore.com/try_again\",\n \"webhook_url\": \"https://mystore.com/internal/webhook\",\n \"payment_methods\": [\n \"paynow_sgd\",\n \"card\"\n ],\n \"transaction_description\": \"test\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\",\n \"key3\": \"value3\"\n },\n \"reference_id\": \"string\",\n \"confirm\": false,\n \"statement_descriptor\": \"string\",\n \"payment_method_details\": {\n \"key\": \"value\"\n },\n \"session_id\": \"test_session_id\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "",
"data": {
"amount": 100,
"amount_paid": 0,
"billing_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"cancel_url": "https://mystore.com/try_again",
"cancelled_at": null,
"client_token": "ZRjM4ROfY6SPjTaQkz00OszWUcVvMA8KhStkPAoamPQ=",
"confirm": false,
"created_at": "2024-10-01T10:08:30.666381739Z",
"customer": "cus_crtqrhth90j0121gpt50",
"customer_details": {
"country": "SG",
"email": "andrea@example.com",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"form": "",
"holding_currency": "INR",
"id": "pay_crtsk7i6avg0t9ndc7l0",
"invoice_currency": "INR",
"items": [],
"latest_payment_attempt": "",
"latest_payment_attempt_data": null,
"metadata": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"object": "payin",
"paid_in_excess": false,
"partially_paid": false,
"payment_attempts": [],
"payment_method_details": {
"key": "value"
},
"reference_id": "string",
"shipping_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"statement_descriptor": "tzp*string",
"status": "requires_payment_method",
"status_description": "",
"success_url": "https://mystore.com/success_page",
"transaction_data": [],
"transaction_description": "test",
"transaction_documents": [],
"webhook_url": "https://mystore.com/internal/webhook"
}
}Payin
Create Payin
Creates a payin object.
POST
/
v3
/
payin
Create a payin
curl --request POST \
--url https://service-sandbox.tazapay.com/v3/payin \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"invoice_currency": "INR",
"amount": 100,
"customer_details": {
"name": "Andrea Lark",
"country": "SG",
"email": "andrea@example.com",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"billing_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"shipping_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"success_url": "https://mystore.com/success_page",
"cancel_url": "https://mystore.com/try_again",
"webhook_url": "https://mystore.com/internal/webhook",
"payment_methods": [
"paynow_sgd",
"card"
],
"transaction_description": "test",
"metadata": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"reference_id": "string",
"confirm": false,
"statement_descriptor": "string",
"payment_method_details": {
"key": "value"
},
"session_id": "test_session_id"
}
'import requests
url = "https://service-sandbox.tazapay.com/v3/payin"
payload = {
"invoice_currency": "INR",
"amount": 100,
"customer_details": {
"name": "Andrea Lark",
"country": "SG",
"email": "andrea@example.com",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"billing_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"shipping_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"success_url": "https://mystore.com/success_page",
"cancel_url": "https://mystore.com/try_again",
"webhook_url": "https://mystore.com/internal/webhook",
"payment_methods": ["paynow_sgd", "card"],
"transaction_description": "test",
"metadata": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"reference_id": "string",
"confirm": False,
"statement_descriptor": "string",
"payment_method_details": { "key": "value" },
"session_id": "test_session_id"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
invoice_currency: 'INR',
amount: 100,
customer_details: {
name: 'Andrea Lark',
country: 'SG',
email: 'andrea@example.com',
phone: {calling_code: '65', number: '87654321'}
},
billing_details: {
address: {
city: 'Singapore',
country: 'SG',
line1: '1st Street',
line2: '2nd Avenue',
postal_code: '43004',
state: 'Singapore'
},
label: 'Home',
name: 'Andrea Lark',
phone: {calling_code: '65', number: '87654321'}
},
shipping_details: {
address: {
city: 'Singapore',
country: 'SG',
line1: '1st Street',
line2: '2nd Avenue',
postal_code: '43004',
state: 'Singapore'
},
label: 'Home',
name: 'Andrea Lark',
phone: {calling_code: '65', number: '87654321'}
},
success_url: 'https://mystore.com/success_page',
cancel_url: 'https://mystore.com/try_again',
webhook_url: 'https://mystore.com/internal/webhook',
payment_methods: ['paynow_sgd', 'card'],
transaction_description: 'test',
metadata: {key1: 'value1', key2: 'value2', key3: 'value3'},
reference_id: 'string',
confirm: false,
statement_descriptor: 'string',
payment_method_details: {key: 'value'},
session_id: 'test_session_id'
})
};
fetch('https://service-sandbox.tazapay.com/v3/payin', 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://service-sandbox.tazapay.com/v3/payin",
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([
'invoice_currency' => 'INR',
'amount' => 100,
'customer_details' => [
'name' => 'Andrea Lark',
'country' => 'SG',
'email' => 'andrea@example.com',
'phone' => [
'calling_code' => '65',
'number' => '87654321'
]
],
'billing_details' => [
'address' => [
'city' => 'Singapore',
'country' => 'SG',
'line1' => '1st Street',
'line2' => '2nd Avenue',
'postal_code' => '43004',
'state' => 'Singapore'
],
'label' => 'Home',
'name' => 'Andrea Lark',
'phone' => [
'calling_code' => '65',
'number' => '87654321'
]
],
'shipping_details' => [
'address' => [
'city' => 'Singapore',
'country' => 'SG',
'line1' => '1st Street',
'line2' => '2nd Avenue',
'postal_code' => '43004',
'state' => 'Singapore'
],
'label' => 'Home',
'name' => 'Andrea Lark',
'phone' => [
'calling_code' => '65',
'number' => '87654321'
]
],
'success_url' => 'https://mystore.com/success_page',
'cancel_url' => 'https://mystore.com/try_again',
'webhook_url' => 'https://mystore.com/internal/webhook',
'payment_methods' => [
'paynow_sgd',
'card'
],
'transaction_description' => 'test',
'metadata' => [
'key1' => 'value1',
'key2' => 'value2',
'key3' => 'value3'
],
'reference_id' => 'string',
'confirm' => false,
'statement_descriptor' => 'string',
'payment_method_details' => [
'key' => 'value'
],
'session_id' => 'test_session_id'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$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://service-sandbox.tazapay.com/v3/payin"
payload := strings.NewReader("{\n \"invoice_currency\": \"INR\",\n \"amount\": 100,\n \"customer_details\": {\n \"name\": \"Andrea Lark\",\n \"country\": \"SG\",\n \"email\": \"andrea@example.com\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"billing_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"shipping_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"success_url\": \"https://mystore.com/success_page\",\n \"cancel_url\": \"https://mystore.com/try_again\",\n \"webhook_url\": \"https://mystore.com/internal/webhook\",\n \"payment_methods\": [\n \"paynow_sgd\",\n \"card\"\n ],\n \"transaction_description\": \"test\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\",\n \"key3\": \"value3\"\n },\n \"reference_id\": \"string\",\n \"confirm\": false,\n \"statement_descriptor\": \"string\",\n \"payment_method_details\": {\n \"key\": \"value\"\n },\n \"session_id\": \"test_session_id\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://service-sandbox.tazapay.com/v3/payin")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"invoice_currency\": \"INR\",\n \"amount\": 100,\n \"customer_details\": {\n \"name\": \"Andrea Lark\",\n \"country\": \"SG\",\n \"email\": \"andrea@example.com\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"billing_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"shipping_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"success_url\": \"https://mystore.com/success_page\",\n \"cancel_url\": \"https://mystore.com/try_again\",\n \"webhook_url\": \"https://mystore.com/internal/webhook\",\n \"payment_methods\": [\n \"paynow_sgd\",\n \"card\"\n ],\n \"transaction_description\": \"test\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\",\n \"key3\": \"value3\"\n },\n \"reference_id\": \"string\",\n \"confirm\": false,\n \"statement_descriptor\": \"string\",\n \"payment_method_details\": {\n \"key\": \"value\"\n },\n \"session_id\": \"test_session_id\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://service-sandbox.tazapay.com/v3/payin")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoice_currency\": \"INR\",\n \"amount\": 100,\n \"customer_details\": {\n \"name\": \"Andrea Lark\",\n \"country\": \"SG\",\n \"email\": \"andrea@example.com\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"billing_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"shipping_details\": {\n \"address\": {\n \"city\": \"Singapore\",\n \"country\": \"SG\",\n \"line1\": \"1st Street\",\n \"line2\": \"2nd Avenue\",\n \"postal_code\": \"43004\",\n \"state\": \"Singapore\"\n },\n \"label\": \"Home\",\n \"name\": \"Andrea Lark\",\n \"phone\": {\n \"calling_code\": \"65\",\n \"number\": \"87654321\"\n }\n },\n \"success_url\": \"https://mystore.com/success_page\",\n \"cancel_url\": \"https://mystore.com/try_again\",\n \"webhook_url\": \"https://mystore.com/internal/webhook\",\n \"payment_methods\": [\n \"paynow_sgd\",\n \"card\"\n ],\n \"transaction_description\": \"test\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\",\n \"key3\": \"value3\"\n },\n \"reference_id\": \"string\",\n \"confirm\": false,\n \"statement_descriptor\": \"string\",\n \"payment_method_details\": {\n \"key\": \"value\"\n },\n \"session_id\": \"test_session_id\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "",
"data": {
"amount": 100,
"amount_paid": 0,
"billing_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"cancel_url": "https://mystore.com/try_again",
"cancelled_at": null,
"client_token": "ZRjM4ROfY6SPjTaQkz00OszWUcVvMA8KhStkPAoamPQ=",
"confirm": false,
"created_at": "2024-10-01T10:08:30.666381739Z",
"customer": "cus_crtqrhth90j0121gpt50",
"customer_details": {
"country": "SG",
"email": "andrea@example.com",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"form": "",
"holding_currency": "INR",
"id": "pay_crtsk7i6avg0t9ndc7l0",
"invoice_currency": "INR",
"items": [],
"latest_payment_attempt": "",
"latest_payment_attempt_data": null,
"metadata": {
"key1": "value1",
"key2": "value2",
"key3": "value3"
},
"object": "payin",
"paid_in_excess": false,
"partially_paid": false,
"payment_attempts": [],
"payment_method_details": {
"key": "value"
},
"reference_id": "string",
"shipping_details": {
"address": {
"city": "Singapore",
"country": "SG",
"line1": "1st Street",
"line2": "2nd Avenue",
"postal_code": "43004",
"state": "Singapore"
},
"label": "Home",
"name": "Andrea Lark",
"phone": {
"calling_code": "65",
"number": "87654321"
}
},
"statement_descriptor": "tzp*string",
"status": "requires_payment_method",
"status_description": "",
"success_url": "https://mystore.com/success_page",
"transaction_data": [],
"transaction_description": "test",
"transaction_documents": [],
"webhook_url": "https://mystore.com/internal/webhook"
}
}After the payin is created, provide payment method details and confirm the payin.
When you use
confirm = true during creation, you create and confirm the payin in the same API call. You MUST use the parameters in confirm API when you supply confirm = trueAuthorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Invoice currency for the checkout session (in uppercase, iso-4217 standard). By default, the invoice currency is the holding currency for the transaction.
Amount in cents. For example if you want to charge $10.12 pass 1012 as the value. For decimal handling for various currencies, refer to the guide here
A short description to be displayed on the Tazapay hosted checkout screen
Details about the customer
Show child attributes
Show child attributes
ID of the customer for the checkout session
URL where the customer is directed to after a successful payment
The URL the customer will be directed to if they decide to cancel payment and return to your website.
Shipping details including recipient name, address and phone
Show child attributes
Show child attributes
Billing details including name, address and phone
Show child attributes
Show child attributes
Supporting documents for the transaction
Set of key-value pairs that can be attached to the object (JSON string format)
Example:
"{\"key1\": \"value1\", \"key2\": \"value2\"}"
Your unique identifier for the session
Set to true to confirm this payin immediately. The parameter defaults to false. When creating and confirming a payin at the same time, you can also provide the parameters in the confirm API
Configure the description of the payment on your customer's statements. It must contain at least one letter and be 1-22 characters long
Pass the data specific to a payment method to confirm a payin and create a payment attempt
Was this page helpful?
⌘I