AtaraPay Docs

AtaraPay Docs

  • Integration
  • API Reference

›Payouts

Integration Overview

  • Get Started
  • Ground-up Development
  • Framework Development

Authentication

  • Calculation of Auth Token

Payment Plugin

  • Inline Integration
  • Standard Integration
  • Go Live

eCommerce Plugin

  • WooCommerce Payment Plugin
  • Magento Payment Extension
  • Shopify Payment Plugin

Payouts

  • Service Provider API
  • Create Service Provider
  • Get Service Provider
  • Delete Service Provider
  • Update Order Commission (Business Seller)
  • Update Order Commission (Marketplace Operator)

Milestone Payments

  • Overview
  • Create Project
  • Update Project
  • Get Project

Order Status Automation

  • Overview
  • Delivery Completed API.
  • Seller Cancels Order API
  • Buyer Cancels Order API
  • Order Status API

Order Notification

  • Overview
  • Delivery Complete Notification
  • Buyer Accepts Order Notification
  • Buyer Rejects Order Notification
  • Buyer Cancels Order Notification
  • Buyer Cancels Disputed Order Notification
  • Seller Cancels Order Notification
  • Seller Cancels Disputed Order Notification
  • Second Delivery Attempt Notification
  • Generation of Security Token

Resources

  • Status Definition
  • Get Bank Details
  • Marketplace Integration
  • Product Features List

Get Service Provider

This API is used to fetch the details of each Service Provider associated with the seller or marketplace operator. Below are the fields that are to be sent via API using POST Method to the Url:

For Staging: http://test-api.atarapay.com/api/serviceprovider
for live: https://api.atarapay.com/api/serviceprovider

NOTE

  1. Ensure that the authtoken is calculated from the Seller’s API keys
  2. Ensure the Service provider is associated to the seller.
  3. The seller first needs to add their own bank account in order to view service providers that are associated to them.
Field nameRequiredDescription
authtokenYesThis is calculated using the steps mentioned here Calculation of Auth Token

Successfull Response

{
    "status": "success",
    "message": "Service providers",
    "data": {
        "id": 4,
        "firstname": "Emeka",
        "lastname": "Adeniyi",
        "phone": "+2348082094382",
        "email": "emeka.adeniyi@atarapay.com",
        "bank_code": "221",
        "nip_bank_code": "000000",
        "bank_name": "Axis",
        "bank_account_name": "Emeka Adeniyi",
        "bank_account_number": "1234567890",
        "recipient_code": null,
        "created_at": "2020-02-20 16:54:01",
        "updated_at": "2020-02-24 21:20:59"
    }
}

Failure Response

{
    "status": "error",
    "message": "The authtoken field is required."
}

Sample codes

C#

var client = new RestClient("http://test-api.atarapay.com/api/serviceprovider");
var request = new RestRequest(Method.POST);;
request.AddHeader("cache-control", "no-cache");
request.AddHeader("content-type", "application/x-www-form-urlencoded");
request.AddParameter("application/x-www-form-urlencoded", "authtoken=__authtoken__", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

PHP

$request = new HttpRequest();
$request->setUrl('http://test-api.atarapay.com/api/serviceprovider');
$request->setMethod(HTTP_METH_POST);

$request->setHeaders(array(
  'cache-control' => 'no-cache',
  'content-type' => 'application/x-www-form-urlencoded'
));

$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array(
  'authtoken' => '__Auth_token_calculated__'
));

try {
  $response = $request->send();

  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}

Node Js

var unirest = require("unirest");

var req = unirest("POST", "http://test-api.atarapay.com/api/serviceprovider");

req.headers({
  "cache-control": "no-cache",
  "content-type": "application/x-www-form-urlencoded"
});

req.form({
  "authtoken": "__Auth_token_calculated__",
});

req.end(function (res) {
  if (res.error) throw new Error(res.error);

  console.log(res.body);
});

← Create Service ProviderDelete Service Provider →
  • NOTE
    • Sample codes
    • Node Js
Docs
IntegrationeCommerce PluginsAPI ReferenceAtaraPay
Other Links
About UsFrequently Asked QuestionsReport a Bug
Merchants
BenefitsOur Merchants
Follow @atarapayonline
AtaraPay
Copyright © 2022 AtaraPay