Donation

This will add a donation to selected campaign from Ayobantu partner.

Create Donation

POST {base_url}/api/v1/partner/donation

Submit new donation to the selected campaign

Headers

Name	Type	Value
Accept	String	application/json
Authorization	String	Bearer <api_token>
Content-Type*	String	application/json

Request Body

Name	Type	Description
name*	String	John Doe (Alpha/Numeric Only)
email	Email	[e-mail] (required if is_fundraiser is true)
partner_code*	String	Provided by Ayobantu. See more, click here
signature_key*	String	Signature code generated every time you make a request. See more, click here. Formula: hash("sha512", name + phone + email + amount + is_anonymous + campaign_id + partner_code + secret_key); Example Output: a2a1d0baa527318794f77122e8b35eb19c83498fb535897d58bcf0fc6a00b3c0de5a113a1d53caa748a0bdcf0b0d6fd941d1ffa6801f0bb99d370f1c83aa13db
campaign_id*	Integer	id is obtained from campaign submitted by partners or can be provided by Ayobantu.
phone*	Numeric	0812345678 or 6287812345678
amount*	Numeric	100000 (without any . or ,)
is_anonymous	Numeric	0 or 1 (default 0)
is_fundraiser (Optional)	Boolean	true or false (default false)

200: OK Success

{ 
   "status_code": "200", 
   "message": "Success", 
   "data": {
         "reference_id" : 8181,
         "amount" : 100000
   } 
}

401: Unauthorized Do not have access

{ 
   "status_code": "401", 
   "message": "Access denied due to unauthorized request. Please check the credentials.",   
   "erros": [ 
        "Invalid signature key"
   ] 
}

404: Not Found Resource not found

{ 
   "status_code": "404", 
   "message": "The requested resource is not found",   
   "erros": [ 
        "Partner not found"
   ] 
}

500: Internal Server Error Internal server error

{ 
   "status_code": "500", 
   "message": "Internal Server Error",   
   "erros": [ 
        "Registration failed"
   ] 
}

422: Unprocessable Entity Unprocessable Entity (Validation Error)

{ 
   "status_code": "422", 
   "message": "Unprocessable Entity",   
   "erros": [ 
        "Name is required",
        "Amount is required
   ] 
}

429: Too Many Requests Too Many Attempts

{ 
   "status_code": "429", 
   "message": "Too Many Attempts",   
   "erros": [ 
        "Please wait 1 minute for next request"
   ] 
}

// Example Generate Signature Key 
//secret_key = '353656da-1695-434b-9f61-a3c9ff90894f';
hash("sha512", 'John [e-mail]500000123AYB12345353656da-1695-434b-9f61-a3c9ff90894f')

//Result
a52fce4c70337fd8749c984f1c8019e3205622b01cd18fc9d3dd3b5c333307c18981a7e90454665e7b42059e4b062c9c306c18bf25da40adafd5040956eacb36

cURL

curl -X POST \
  {base_url}/api/v1/partner/donation \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer 88A4B7FEADD1667B' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
        "name"  : "John Doe",
        "phone" : "0812345678",
        "amount" : "50000",
        "email" : "[e-mail]",
        "partner_code" : "AYB12345",
        "signature_key" : "a52fce4c70337fd8749c984f1c8019e3205622b01cd18fc9d3dd3b5c333307c18981a7e90454665e7b42059e4b062c9c306c18bf25da40adafd5040956eacb36",
        "campaign_id"   : 123,
        "is_anonymous"    : 0,
        "is_fundraiser" : false
}'

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => {base_url}.'/api/v1/partner/donation',
  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 =>'{
    "name"  : "John Doe",
    "phone" : "0812345678",
    "amount" : "50000",
    "email" : "[e-mail]",
    "partner_code" : "AYB12345",
    "signature_key" : "a52fce4c70337fd8749c984f1c8019e3205622b01cd18fc9d3dd3b5c333307c18981a7e90454665e7b42059e4b062c9c306c18bf25da40adafd5040956eacb36",
    "campaign_id"   : 123,
    "is_anonymous"    : 0,
    "is_fundraiser"   : false
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 88A4B7FEADD1667B',
    'Accept: application/json',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Go

package main

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

func main() {

  url := {base_url}+"/api/v1/partner/donation"
  method := "POST"

  payload := strings.NewReader(`{
    "name"  : "John Doe",
    "phone" : "0812345678",
    "amount" : "50000",
    "email" : "[e-mail]",
    "partner_code" : "AYB12345",
    "signature_key" : "a52fce4c70337fd8749c984f1c8019e3205622b01cd18fc9d3dd3b5c333307c18981a7e90454665e7b42059e4b062c9c306c18bf25da40adafd5040956eacb36",
    "campaign_id"   : 123,
    "is_anonymous"    : 0,
    "is_fundraiser"   : false
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer 88A4B7FEADD1667B")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}