Add Beneficiary Payment Details

To add Payment details to a beneficiary:

STEP 1

Make a GET {{baseUrl}}/beneficiary/form/show/{{gatewayID}}to get the Dynamic Form (The form response is different for each gateway) for adding the beneficiary details

Request

Headers

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Request Example

import requests

gateway_id = "331" // example gateway ID
url = f"{{baseUrl}}/beneficiary/form/show/{gateway_id}"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

<?php

$gateway_id = "331"; // example gateway ID
$url = "{{baseUrl}}/beneficiary/form/show/" . $gateway_id;
$headers = array(
    "Authorization: Bearer YOUR_ACCESS_TOKEN"
);

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers
));

$response = curl_exec($curl);

if (curl_errno($curl)) {
    echo 'Error:' . curl_error($curl);
} else {
    echo $response;
}

curl_close($curl);
?>

const gateway_id = "331"; //example gateway ID
const url = `{{baseUrl}}/beneficiary/form/show/${gateway_id}`;

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
};

fetch(url, options)
  .then(response => {
    if (!response.ok) {
      throw new Error('Network response was not ok ' + response.statusText);
    }
    return response.json();
  })
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

curl -X GET "{{baseUrl}}/beneficiary/form/show/331" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example response of the Dynamic Form

{
    "nickname": "John Doe Vitawallet",
    "gateway_id": 331,
    "currency": "USD",
    "beneficiary_id": 17,
    "payment_data": {
        "beneficiary_type": "",
        "beneficiary_first_name": "",
        "beneficiary_last_name": "",
        "company_name": "",
        "beneficiary_email": "",
        "state": "",
        "city": "",
        "beneficiary_address": "",
        "zipcode": "",
        "beneficiary_document_type": "",
        "beneficiary_document_number": "",
        "account_type_bank": "",
        "account_bank": "",
        "routing_number": "",
        "purpose": "",
        "purpose_comentary": ""
    }
}

STEP 2

Make a post request using the filled dynamic form as body

POST {{baseUrl}}/beneficiaries/payment-methods/

this form Requires the Beneficiary ID (gotten in the response when you Add Beneficiary or Get Beneficiaries) to bind the payment details to the Beneficiary

Request

Headers

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Request Example

NOTE: This body example matches the retrieved dynamic form from Gateway ID 331 in the above example

{
    "nickname": "John Doe Vitawallet",
    "gateway_id": 331,
    "currency": "USD",
    "beneficiary_id": 17,
    "payment_data": {
        "beneficiary_type": "Individual",
        "beneficiary_first_name": "John",
        "beneficiary_last_name": "Doe",
        "company_name": "Zee Technologies",
        "beneficiary_email": "john.doe@example.com",
        "state": "California",
        "city": "Los Angeles",
        "beneficiary_address": "123 Main St",
        "zipcode": "90001",
        "beneficiary_document_type": "DNI",
        "beneficiary_document_number": "12345678",
        "account_type_bank": "Checking",
        "account_bank": "1234567890123456",
        "routing_number": "987654321",
        "purpose": "ISGDDS",
        "purpose_comentary": "For business purposes"
    }
}

Example Request

import requests
import json

url = "https://api.yourservice.com/beneficiaries/payment-methods/"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "nickname": "John Doe Vitawallet",
    "gateway_id": 331,
    "currency": "USD",
    "beneficiary_id": 17,
    "payment_data": {
        "beneficiary_type": "Individual",
        "beneficiary_first_name": "John",
        "beneficiary_last_name": "Doe",
        "company_name": "Zee Technologies",
        "beneficiary_email": "john.doe@example.com",
        "state": "California",
        "city": "Los Angeles",
        "beneficiary_address": "123 Main St",
        "zipcode": "90001",
        "beneficiary_document_type": "DNI",
        "beneficiary_document_number": "12345678",
        "account_type_bank": "Checking",
        "account_bank": "1234567890123456",
        "routing_number": "987654321",
        "purpose": "ISGDDS",
        "purpose_comentary": "For business purposes"
    }
}

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

<?php

$url = `{{baseUrl}}/beneficiaries/payment-methods/`;
$headers = array(
    "Authorization: Bearer YOUR_ACCESS_TOKEN",
    "Content-Type: application/json"
);
$data = json_encode(array(
    "nickname" => "John Doe Vitawallet",
    "gateway_id" => 331,
    "currency" => "USD",
    "beneficiary_id" => 17,
    "payment_data" => array(
        "beneficiary_type" => "Individual",
        "beneficiary_first_name" => "John",
        "beneficiary_last_name" => "Doe",
        "company_name" => "Zee Technologies",
        "beneficiary_email" => "john.doe@example.com",
        "state" => "California",
        "city" => "Los Angeles",
        "beneficiary_address" => "123 Main St",
        "zipcode" => "90001",
        "beneficiary_document_type" => "DNI",
        "beneficiary_document_number" => "12345678",
        "account_type_bank" => "Checking",
        "account_bank" => "1234567890123456",
        "routing_number" => "987654321",
        "purpose" => "ISGDDS",
        "purpose_comentary" => "For business purposes"
    )
));

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data
));

$response = curl_exec($curl);

if (curl_errno($curl)) {
    echo 'Error:' . curl_error($curl);
} else {
    echo $response;
}

curl_close($curl);
?>

const url = `{{baseUrl}}/beneficiaries/payment-methods/`

const data = {
    nickname: "John Doe Vitawallet",
    gateway_id: 331,
    currency: "USD",
    beneficiary_id: 17,
    payment_data: {
        beneficiary_type: "Individual",
        beneficiary_first_name: "John",
        beneficiary_last_name: "Doe",
        company_name: "Zee Technologies",
        beneficiary_email: "john.doe@example.com",
        state: "California",
        city: "Los Angeles",
        beneficiary_address: "123 Main St",
        zipcode: "90001",
        beneficiary_document_type: "DNI",
        beneficiary_document_number: "12345678",
        account_type_bank: "Checking",
        account_bank: "1234567890123456",
        routing_number: "987654321",
        purpose: "ISGDDS",
        purpose_comentary: "For business purposes"
    }
};

fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

curl -X POST "{{baseUrl}}/beneficiaries/payment-methods/" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "nickname": "John Doe Vitawallet",
           "gateway_id": 331,
           "currency": "USD",
           "beneficiary_id": 17,
           "payment_data": {
               "beneficiary_type": "Individual",
               "beneficiary_first_name": "John",
               "beneficiary_last_name": "Doe",
               "company_name": "Zee Technologies",
               "beneficiary_email": "john.doe@example.com",
               "state": "California",
               "city": "Los Angeles",
               "beneficiary_address": "123 Main St",
               "zipcode": "90001",
               "beneficiary_document_type": "DNI",
               "beneficiary_document_number": "12345678",
               "account_type_bank": "Checking",
               "account_bank": "1234567890123456",
               "routing_number": "987654321",
               "purpose": "ISGDDS",
               "purpose_comentary": "For business purposes"
           }
         }'

PreviousGet Beneficiaries NextUpdate Beneficiary

Last updated 3 months ago