Public

Start bank redirect for a campaign donation

Public, throttled to 30 requests per minute. Submit one recipient with amount/donation_amount, or a non-empty designations cart. Amounts must be positive decimals and allowed recurring selections must satisfy each program amount policy. Additional gifts must use designations allowed by the donor form and valid recipient routing. Existing donor emails require the verified checkout session; new donors must satisfy public donor identity and conditional form requirements. Recurring gifts require reusable bank support, while a valid future next date confirms the bank account for later collection. return_path is relative to the client app. A stale supplied policy_revision returns 409; a missing configured donor form returns 400. The method stores validated checkout details for bank-confirmed replay.

POST

frontend

checkout

campaign-ideal

{client_id}

{program_id}

{session_id}

Start bank redirect for a campaign donation

curl --request POST \
  --url https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "return_path": "/donate/return",
  "first_name": "<string>",
  "last_name": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "phone": "<string>",
  "street": "<string>",
  "street2": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zip": "<string>",
  "country": "<string>",
  "organization_name": "<string>",
  "signup_username": "<string>",
  "policy_revision": "<string>",
  "type": "INDIVIDUAL",
  "custom_fields": {},
  "check_number": "<string>",
  "next": "2023-12-25",
  "entity_id": 123,
  "amount": 1.01,
  "donation_amount": 1.01,
  "frequency": "one time",
  "is_custom_amount": true,
  "designations": [
    {
      "entity_id": 123,
      "amount": 1.01,
      "frequency": "<string>",
      "is_custom_amount": true
    }
  ],
  "additional_gifts": [
    {
      "designation_id": 123,
      "amount": 1.01,
      "attach_to_other_entity": true,
      "other_entity_id": 123
    }
  ],
  "confirmation_token": "ctoken_example123"
}
'

import requests

url = "https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}"

payload = {
    "email": "jsmith@example.com",
    "return_path": "/donate/return",
    "first_name": "<string>",
    "last_name": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "phone": "<string>",
    "street": "<string>",
    "street2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>",
    "country": "<string>",
    "organization_name": "<string>",
    "signup_username": "<string>",
    "policy_revision": "<string>",
    "type": "INDIVIDUAL",
    "custom_fields": {},
    "check_number": "<string>",
    "next": "2023-12-25",
    "entity_id": 123,
    "amount": 1.01,
    "donation_amount": 1.01,
    "frequency": "one time",
    "is_custom_amount": True,
    "designations": [
        {
            "entity_id": 123,
            "amount": 1.01,
            "frequency": "<string>",
            "is_custom_amount": True
        }
    ],
    "additional_gifts": [
        {
            "designation_id": 123,
            "amount": 1.01,
            "attach_to_other_entity": True,
            "other_entity_id": 123
        }
    ],
    "confirmation_token": "ctoken_example123"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: 'jsmith@example.com',
    return_path: '/donate/return',
    first_name: '<string>',
    last_name: '<string>',
    firstName: '<string>',
    lastName: '<string>',
    phone: '<string>',
    street: '<string>',
    street2: '<string>',
    city: '<string>',
    state: '<string>',
    zip: '<string>',
    country: '<string>',
    organization_name: '<string>',
    signup_username: '<string>',
    policy_revision: '<string>',
    type: 'INDIVIDUAL',
    custom_fields: {},
    check_number: '<string>',
    next: '2023-12-25',
    entity_id: 123,
    amount: 1.01,
    donation_amount: 1.01,
    frequency: 'one time',
    is_custom_amount: true,
    designations: [{entity_id: 123, amount: 1.01, frequency: '<string>', is_custom_amount: true}],
    additional_gifts: [
      {
        designation_id: 123,
        amount: 1.01,
        attach_to_other_entity: true,
        other_entity_id: 123
      }
    ],
    confirmation_token: 'ctoken_example123'
  })
};

fetch('https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}', 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.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}",
  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([
    'email' => 'jsmith@example.com',
    'return_path' => '/donate/return',
    'first_name' => '<string>',
    'last_name' => '<string>',
    'firstName' => '<string>',
    'lastName' => '<string>',
    'phone' => '<string>',
    'street' => '<string>',
    'street2' => '<string>',
    'city' => '<string>',
    'state' => '<string>',
    'zip' => '<string>',
    'country' => '<string>',
    'organization_name' => '<string>',
    'signup_username' => '<string>',
    'policy_revision' => '<string>',
    'type' => 'INDIVIDUAL',
    'custom_fields' => [
        
    ],
    'check_number' => '<string>',
    'next' => '2023-12-25',
    'entity_id' => 123,
    'amount' => 1.01,
    'donation_amount' => 1.01,
    'frequency' => 'one time',
    'is_custom_amount' => true,
    'designations' => [
        [
                'entity_id' => 123,
                'amount' => 1.01,
                'frequency' => '<string>',
                'is_custom_amount' => true
        ]
    ],
    'additional_gifts' => [
        [
                'designation_id' => 123,
                'amount' => 1.01,
                'attach_to_other_entity' => true,
                'other_entity_id' => 123
        ]
    ],
    'confirmation_token' => 'ctoken_example123'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}"

	payload := strings.NewReader("{\n  \"email\": \"jsmith@example.com\",\n  \"return_path\": \"/donate/return\",\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"street\": \"<string>\",\n  \"street2\": \"<string>\",\n  \"city\": \"<string>\",\n  \"state\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"country\": \"<string>\",\n  \"organization_name\": \"<string>\",\n  \"signup_username\": \"<string>\",\n  \"policy_revision\": \"<string>\",\n  \"type\": \"INDIVIDUAL\",\n  \"custom_fields\": {},\n  \"check_number\": \"<string>\",\n  \"next\": \"2023-12-25\",\n  \"entity_id\": 123,\n  \"amount\": 1.01,\n  \"donation_amount\": 1.01,\n  \"frequency\": \"one time\",\n  \"is_custom_amount\": true,\n  \"designations\": [\n    {\n      \"entity_id\": 123,\n      \"amount\": 1.01,\n      \"frequency\": \"<string>\",\n      \"is_custom_amount\": true\n    }\n  ],\n  \"additional_gifts\": [\n    {\n      \"designation_id\": 123,\n      \"amount\": 1.01,\n      \"attach_to_other_entity\": true,\n      \"other_entity_id\": 123\n    }\n  ],\n  \"confirmation_token\": \"ctoken_example123\"\n}")

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

	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.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jsmith@example.com\",\n  \"return_path\": \"/donate/return\",\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"street\": \"<string>\",\n  \"street2\": \"<string>\",\n  \"city\": \"<string>\",\n  \"state\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"country\": \"<string>\",\n  \"organization_name\": \"<string>\",\n  \"signup_username\": \"<string>\",\n  \"policy_revision\": \"<string>\",\n  \"type\": \"INDIVIDUAL\",\n  \"custom_fields\": {},\n  \"check_number\": \"<string>\",\n  \"next\": \"2023-12-25\",\n  \"entity_id\": 123,\n  \"amount\": 1.01,\n  \"donation_amount\": 1.01,\n  \"frequency\": \"one time\",\n  \"is_custom_amount\": true,\n  \"designations\": [\n    {\n      \"entity_id\": 123,\n      \"amount\": 1.01,\n      \"frequency\": \"<string>\",\n      \"is_custom_amount\": true\n    }\n  ],\n  \"additional_gifts\": [\n    {\n      \"designation_id\": 123,\n      \"amount\": 1.01,\n      \"attach_to_other_entity\": true,\n      \"other_entity_id\": 123\n    }\n  ],\n  \"confirmation_token\": \"ctoken_example123\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jsmith@example.com\",\n  \"return_path\": \"/donate/return\",\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"street\": \"<string>\",\n  \"street2\": \"<string>\",\n  \"city\": \"<string>\",\n  \"state\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"country\": \"<string>\",\n  \"organization_name\": \"<string>\",\n  \"signup_username\": \"<string>\",\n  \"policy_revision\": \"<string>\",\n  \"type\": \"INDIVIDUAL\",\n  \"custom_fields\": {},\n  \"check_number\": \"<string>\",\n  \"next\": \"2023-12-25\",\n  \"entity_id\": 123,\n  \"amount\": 1.01,\n  \"donation_amount\": 1.01,\n  \"frequency\": \"one time\",\n  \"is_custom_amount\": true,\n  \"designations\": [\n    {\n      \"entity_id\": 123,\n      \"amount\": 1.01,\n      \"frequency\": \"<string>\",\n      \"is_custom_amount\": true\n    }\n  ],\n  \"additional_gifts\": [\n    {\n      \"designation_id\": 123,\n      \"amount\": 1.01,\n      \"attach_to_other_entity\": true,\n      \"other_entity_id\": 123\n    }\n  ],\n  \"confirmation_token\": \"ctoken_example123\"\n}"

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

{
  "status": "redirect",
  "checkout_token": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "checkout_secret": "<string>",
  "redirect_url": "<string>",
  "program_id": 123
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

Path Parameters

client_id

integer

required

Client id.

Required range: x >= 1

Example:

207

program_id

string

required

Program id. Program route; order/cart methods may accept hyphen-separated program IDs.

Example:

"11"

session_id

string

required

Session id. Frontend or recipient session ID belonging to this organization.

Example:

"checkout-session-from-response"

Body

application/json

Request fields accepted by this operation. Omitted optional properties retain the behavior described above.

string<email>

required

Required for campaign and new signup checkout. Existing donor email requires a verified checkout session before payment.

return_path

string

required

Required app-relative return path: starts with one slash, never //, and contains no backslash.

Required string length: 1 - 2000

Pattern: ^/(?!/)[^\\\\]*$

Example:

"/donate/return"

first_name

string

last_name

string

firstName

string

lastName

string

phone

string

street

string

street2

string

city

string

state

string

zip

string

country

string

organization_name

string

Maximum string length: 255

Required and unique within the organization when checkout_mode=signup.

Minimum string length: 5

policy_revision

string

type

enum<string>

default:INDIVIDUAL

Organization identity requires organization_name (max 255). Missing type normalizes to INDIVIDUAL.

Available options:

INDIVIDUAL,

ORGANIZATION

custom_fields

object | null

Public donation-field map, at most 100 keys, admitted by donation_field_checkout_v1 and currently visible definitions. Required public fields and select choices are enforced; hidden conditional children are excluded. Text is at most 5000 characters; date values use Y-m-d, numbers are numeric. With the rollout disabled, this map must be empty.

Show child attributes

check_number

string | null

Maximum string length: 100

string<date>

Optional recurring start date; a valid future date creates a setup-only bank confirmation.

entity_id

integer

Required when no non-empty designations cart is supplied.

amount

number

Single recipient amount; required without donation_amount unless a cart is supplied.

Required range: x >= 0.01

donation_amount

number

Legacy single-recipient amount alias.

Required range: x >= 0.01

frequency

string

default:one time

Single-recipient payment frequency label.

is_custom_amount

boolean

designations

object[]

Minimum array length: 1

Show child attributes

additional_gifts

object[] | null

Show child attributes

confirmation_token

string | null

Optional Stripe native iDEAL confirmation token for this checkout processor.

Maximum string length: 255

Pattern: ^ctoken_[A-Za-z0-9]+$

Example:

"ctoken_example123"

Response

Start bank redirect for a campaign donation response.

status

enum<string>

Available options:

redirect

checkout_token

string<uuid>

checkout_secret

string

Browser possession secret for disclosing the full result; retain alongside the checkout token.

redirect_url

string<uri> | null

Provider bank redirect, possibly null when already confirmed or no next action is required.

program_id

integer

Present for order checkout. Use this anchor ID when completing/canceling an order with a composite program route.

Start bank redirect for a campaign donation

curl --request POST \
  --url https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "return_path": "/donate/return",
  "first_name": "<string>",
  "last_name": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "phone": "<string>",
  "street": "<string>",
  "street2": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zip": "<string>",
  "country": "<string>",
  "organization_name": "<string>",
  "signup_username": "<string>",
  "policy_revision": "<string>",
  "type": "INDIVIDUAL",
  "custom_fields": {},
  "check_number": "<string>",
  "next": "2023-12-25",
  "entity_id": 123,
  "amount": 1.01,
  "donation_amount": 1.01,
  "frequency": "one time",
  "is_custom_amount": true,
  "designations": [
    {
      "entity_id": 123,
      "amount": 1.01,
      "frequency": "<string>",
      "is_custom_amount": true
    }
  ],
  "additional_gifts": [
    {
      "designation_id": 123,
      "amount": 1.01,
      "attach_to_other_entity": true,
      "other_entity_id": 123
    }
  ],
  "confirmation_token": "ctoken_example123"
}
'

import requests

url = "https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}"

payload = {
    "email": "jsmith@example.com",
    "return_path": "/donate/return",
    "first_name": "<string>",
    "last_name": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "phone": "<string>",
    "street": "<string>",
    "street2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>",
    "country": "<string>",
    "organization_name": "<string>",
    "signup_username": "<string>",
    "policy_revision": "<string>",
    "type": "INDIVIDUAL",
    "custom_fields": {},
    "check_number": "<string>",
    "next": "2023-12-25",
    "entity_id": 123,
    "amount": 1.01,
    "donation_amount": 1.01,
    "frequency": "one time",
    "is_custom_amount": True,
    "designations": [
        {
            "entity_id": 123,
            "amount": 1.01,
            "frequency": "<string>",
            "is_custom_amount": True
        }
    ],
    "additional_gifts": [
        {
            "designation_id": 123,
            "amount": 1.01,
            "attach_to_other_entity": True,
            "other_entity_id": 123
        }
    ],
    "confirmation_token": "ctoken_example123"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: 'jsmith@example.com',
    return_path: '/donate/return',
    first_name: '<string>',
    last_name: '<string>',
    firstName: '<string>',
    lastName: '<string>',
    phone: '<string>',
    street: '<string>',
    street2: '<string>',
    city: '<string>',
    state: '<string>',
    zip: '<string>',
    country: '<string>',
    organization_name: '<string>',
    signup_username: '<string>',
    policy_revision: '<string>',
    type: 'INDIVIDUAL',
    custom_fields: {},
    check_number: '<string>',
    next: '2023-12-25',
    entity_id: 123,
    amount: 1.01,
    donation_amount: 1.01,
    frequency: 'one time',
    is_custom_amount: true,
    designations: [{entity_id: 123, amount: 1.01, frequency: '<string>', is_custom_amount: true}],
    additional_gifts: [
      {
        designation_id: 123,
        amount: 1.01,
        attach_to_other_entity: true,
        other_entity_id: 123
      }
    ],
    confirmation_token: 'ctoken_example123'
  })
};

fetch('https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}', 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.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}",
  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([
    'email' => 'jsmith@example.com',
    'return_path' => '/donate/return',
    'first_name' => '<string>',
    'last_name' => '<string>',
    'firstName' => '<string>',
    'lastName' => '<string>',
    'phone' => '<string>',
    'street' => '<string>',
    'street2' => '<string>',
    'city' => '<string>',
    'state' => '<string>',
    'zip' => '<string>',
    'country' => '<string>',
    'organization_name' => '<string>',
    'signup_username' => '<string>',
    'policy_revision' => '<string>',
    'type' => 'INDIVIDUAL',
    'custom_fields' => [
        
    ],
    'check_number' => '<string>',
    'next' => '2023-12-25',
    'entity_id' => 123,
    'amount' => 1.01,
    'donation_amount' => 1.01,
    'frequency' => 'one time',
    'is_custom_amount' => true,
    'designations' => [
        [
                'entity_id' => 123,
                'amount' => 1.01,
                'frequency' => '<string>',
                'is_custom_amount' => true
        ]
    ],
    'additional_gifts' => [
        [
                'designation_id' => 123,
                'amount' => 1.01,
                'attach_to_other_entity' => true,
                'other_entity_id' => 123
        ]
    ],
    'confirmation_token' => 'ctoken_example123'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}"

	payload := strings.NewReader("{\n  \"email\": \"jsmith@example.com\",\n  \"return_path\": \"/donate/return\",\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"street\": \"<string>\",\n  \"street2\": \"<string>\",\n  \"city\": \"<string>\",\n  \"state\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"country\": \"<string>\",\n  \"organization_name\": \"<string>\",\n  \"signup_username\": \"<string>\",\n  \"policy_revision\": \"<string>\",\n  \"type\": \"INDIVIDUAL\",\n  \"custom_fields\": {},\n  \"check_number\": \"<string>\",\n  \"next\": \"2023-12-25\",\n  \"entity_id\": 123,\n  \"amount\": 1.01,\n  \"donation_amount\": 1.01,\n  \"frequency\": \"one time\",\n  \"is_custom_amount\": true,\n  \"designations\": [\n    {\n      \"entity_id\": 123,\n      \"amount\": 1.01,\n      \"frequency\": \"<string>\",\n      \"is_custom_amount\": true\n    }\n  ],\n  \"additional_gifts\": [\n    {\n      \"designation_id\": 123,\n      \"amount\": 1.01,\n      \"attach_to_other_entity\": true,\n      \"other_entity_id\": 123\n    }\n  ],\n  \"confirmation_token\": \"ctoken_example123\"\n}")

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

	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.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jsmith@example.com\",\n  \"return_path\": \"/donate/return\",\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"street\": \"<string>\",\n  \"street2\": \"<string>\",\n  \"city\": \"<string>\",\n  \"state\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"country\": \"<string>\",\n  \"organization_name\": \"<string>\",\n  \"signup_username\": \"<string>\",\n  \"policy_revision\": \"<string>\",\n  \"type\": \"INDIVIDUAL\",\n  \"custom_fields\": {},\n  \"check_number\": \"<string>\",\n  \"next\": \"2023-12-25\",\n  \"entity_id\": 123,\n  \"amount\": 1.01,\n  \"donation_amount\": 1.01,\n  \"frequency\": \"one time\",\n  \"is_custom_amount\": true,\n  \"designations\": [\n    {\n      \"entity_id\": 123,\n      \"amount\": 1.01,\n      \"frequency\": \"<string>\",\n      \"is_custom_amount\": true\n    }\n  ],\n  \"additional_gifts\": [\n    {\n      \"designation_id\": 123,\n      \"amount\": 1.01,\n      \"attach_to_other_entity\": true,\n      \"other_entity_id\": 123\n    }\n  ],\n  \"confirmation_token\": \"ctoken_example123\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/frontend/checkout/campaign-ideal/{client_id}/{program_id}/{session_id}")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jsmith@example.com\",\n  \"return_path\": \"/donate/return\",\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"street\": \"<string>\",\n  \"street2\": \"<string>\",\n  \"city\": \"<string>\",\n  \"state\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"country\": \"<string>\",\n  \"organization_name\": \"<string>\",\n  \"signup_username\": \"<string>\",\n  \"policy_revision\": \"<string>\",\n  \"type\": \"INDIVIDUAL\",\n  \"custom_fields\": {},\n  \"check_number\": \"<string>\",\n  \"next\": \"2023-12-25\",\n  \"entity_id\": 123,\n  \"amount\": 1.01,\n  \"donation_amount\": 1.01,\n  \"frequency\": \"one time\",\n  \"is_custom_amount\": true,\n  \"designations\": [\n    {\n      \"entity_id\": 123,\n      \"amount\": 1.01,\n      \"frequency\": \"<string>\",\n      \"is_custom_amount\": true\n    }\n  ],\n  \"additional_gifts\": [\n    {\n      \"designation_id\": 123,\n      \"amount\": 1.01,\n      \"attach_to_other_entity\": true,\n      \"other_entity_id\": 123\n    }\n  ],\n  \"confirmation_token\": \"ctoken_example123\"\n}"

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

{
  "status": "redirect",
  "checkout_token": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "checkout_secret": "<string>",
  "redirect_url": "<string>",
  "program_id": 123
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}