NNarya Developers
API referenceAcquirers

List acquirers

GET
/integration/v1/acquirers

Lists the acquirers your integration key can reach.

Find an acquirer by your own reference with external_ref.

Authorization

integrationKey
headerAuthorizationBearer <token>

Your integration key, sent as Authorization: Bearer nik_<prefix>_<secret>. Narya issues it.

Query Parameters

page?integer
Range1 <= value
Default1
limit?integer
Range1 <= value <= 100
Default20
external_ref?string

Your identifier, matched exactly.

Match^\S(.*\S)?$
Length1 <= length <= 128
status?string
Value in"active""inactive"
sort?string

Orders by a field, ascending, or descending with a - prefix. Ties break on id. Without it the list is in id order, or in updated_at order when you send updated_after. sort=updated_at leaves out changes from the last 30 seconds, as updated_after describes; sort=-updated_at does not.

Value in"created_at""-created_at""updated_at""-updated_at""name""-name""status""-status"
include_deleted?boolean

With true, deleted records are returned too, with deleted_at set. Use it with sort=updated_at to sync deletions.

Defaultfalse
updated_after?string

Returns records changed after this time, in sort=updated_at order. Any other sort, including -updated_at, is a 400. Send a record's updated_at exactly as you received it. With updated_after or sort=updated_at, changes from the last 30 seconds are left out until they are saved, so a sync never skips one.

Formatdate-time
updated_after_id?string

Sent with updated_after, from the same record; without updated_after it is a 400. Among records changed at exactly updated_after, returns only those after this id.

Formatuuid

Response Body

A page of acquirers

application/json
  1. response
data*array<>
page*integer
Range1 <= value
limit*integer
Range1 <= value <= 100
total_count*integer
Range0 <= value
total_is_capped*boolean
total_pages*integer
Range0 <= value
has_more*boolean
Example Request
curl -X GET 'https://api-narya-staging.pmadvisors.my/integration/v1/acquirers'
Example Response
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "external_ref": "ACQ-MBB",      "name": "string",      "status": "active",      "business_reg_no": "string",      "tax_id_no": "string",      "sst_no": "string",      "contact": {        "person": "string",        "phone": "string",        "email": "user@example.com"      },      "address": {        "line1": "string",        "line2": "string",        "city": "string",        "postcode": "string",        "state": "MY-01",        "country": "MY"      },      "billing": {        "name": "string",        "address": {          "line1": "string",          "line2": "string",          "city": "string",          "postcode": "string",          "state": "MY-01",          "country": "MY"        }      },      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "deleted_at": "2019-08-24T14:15:22Z"    }  ],  "page": 1,  "limit": 1,  "total_count": 0,  "total_is_capped": true,  "total_pages": 0,  "has_more": true}