Visa Direct
Payout API for West Africa

Base URL

https://stg-backend.cgseerapps.co

Authentication

Request

cURL:
curl --location --request POST 'https://stg-backend.cgseerapps.com/api/v1/payout/authenticate' \
--header 'Content-Type: application/json' \
--data-raw '{
"publickey": "publickey1",
"privatekey": "privatekey1"
}'

Response

Response
Error Response
{
"code": "success",
"message": "authentication successful",
"access_token": "5c489069-384f-3bd7-866d-ccbb7dbf0b9b",
"expires_in": 1800
}
{
"code": "error",
"message": "Invalid credentials",
"access_token": null,
"expires_in": null
}

Add Customer Card

Request
curl --location --request POST 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card' \
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f' \
--header 'Content-Type: application/json' \
--data-raw '{
"source": {
"customer": {
"card": [
{
"id": "card1234555555_122m",
"scheme": "VISA"
}
]
}
}
}'
Response
{
"code": "success",
"message": "successful",
"transaction": {},
"source": {
"customer": {
"cards": [
{
"scheme": "VISA",
"id": "card1234555555_122m",
"uniquecode": "c82d514579c24056a7e21032b82bf1c5"
}
]
}
}
}

Get all Customer Cards

curl --location --request GET 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card' \
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f'
Response
{
"code": "success",
"message": "successful",
"source": {
"customer": {
"cards": [
{
"id": "card1234555555_1",
"uniquecode": "529c9c64f5a44f5599bff7aeecf43487",
"added": "2021-09-06 08:47:22.0"
},
{
"id": "card1234555555_12",
"uniquecode": "65d126b02fa44fa6b1de624151d2c652",
"added": "2021-09-06 08:48:33.0"
},
{
"id": "card1234555555_121m",
"uniquecode": "4531dcaf3d654c38b5f5ef402a339667",
"added": "2021-09-06 14:50:07.0"
},
{
"id": "card1234555555_121mm",
"uniquecode": "6aa04b64ad594333bae39ca45f23f8e5",
"added": "2021-09-06 15:03:39.0"
},
{
"id": "card1234555555_121dmm",
"uniquecode": "c56ebf8e03b94b15a30964a66693fe53",
"added": "2021-09-06 15:05:32.0"
},
{
"id": "card12345d55555_121m",
"uniquecode": "79ce42c54fd24f0f83b2efe6f33eafea",
"added": "2021-09-07 07:24:05.0"
},
{
"id": "card12345d55555_121em",
"uniquecode": "6ac7e5ee261045e88558941136b28ada",
"added": "2021-09-07 07:28:03.0"
},
{
"first6": "455616",
"last4": "9090",
"id": "card1234b5d5k5555_121m",
"uniquecode": "3e007dc819bb43c6931e479e69c9497a",
"added": "2021-09-07 13:13:29.0"
},
{
"id": "card1234b5de5k5555_121m",
"uniquecode": "703d60795be54590afd84af6ff99f5dd",
"added": "2021-09-07 14:32:15.0"
},
{
"id": "card1234555555_122m",
"uniquecode": "c82d514579c24056a7e21032b82bf1c5",
"added": "2021-09-09 16:54:34.0"
}
]
}
}
}

Get Customer Card

curl --location --request GET 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card?id=card1234b5de5k5555_121m' \
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f'
Response
{
"code": "success",
"message": "successful",
"source": {
"customer": {
"cards": [
{
"id": "card1234b5de5k5555_121m",
"uniquecode": "703d60795be54590afd84af6ff99f5dd",
"added": "2021-09-07 14:32:15.0"
}
]
}
}
}

Detele Customer Card

curl --location --request DELETE 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card/card1234555555' \
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f'
Response
{
"code": "success",
"message": "successful",
"source": {
"customer": {
"cards": []
}
}
}

Fund Customer Card

curl --location --request PUT 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card/card1234555555_1' \
--header 'Authorization: Bearer e808dc00-de36-305f-ba15-5caffdc33a82' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction": {
"reference": "M1603t798eg9106n10m_y124"
},
"order": {
"amount": "10",
"currency": "NGN"
}
}'
Response
{
"code": "S20",
"message": "Transaction is pending",
"transaction": {
"reference": "M1603t798eg9106n10m_y124",
"linkingreference": "SEERBITITX442514021631205756428"
},
"source": {
"customer": {
"cards": [
{
"id": "card1234555555_1",
"uniquecode": "529c9c64f5a44f5599bff7aeecf43487",
"added": "2021-09-06 08:47:22.0"
}
]
}
}
}

Get Fund Customer Card Status

curl --location --request GET 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card/card1234555555_1?reference=M1603t798eg9106n10m_y124' \
--header 'Authorization: Bearer e808dc00-de36-305f-ba15-5caffdc33a82'
Response
{
"code": "S20",
"message": "Transaction is pending",
"transaction": {
"reference": "M1603t798eg9106n10m_y124",
"linkingreference": "SEERBITITX442514021631205756428"
},
"order": {
"amount": "10.0000",
"currency": "NGN"
},
"source": {
"customer": {
"cards": [
{
"id": "card1234555555_1",
"uniquecode": "529c9c64f5a44f5599bff7aeecf43487",
"added": "2021-09-06 08:47:22.0"
}
]
}
}
}

Add Customer

curl --location --request POST 'https://stg-backend.cgseerapps.com/api/v1/payout/customer' \
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f' \
--header 'Content-Type: application/json' \
--data-raw '{
"source": {
"customer": {
"firstname": "John",
"middlename": "Freeman",
"lastname": "Doe",
"msisdn": "23380745678491444",
"identifier": "user5467890-33333_2",
"address": [
{
"line1": "1234 hamptons",
"line2": "hillsbay",
"postalcode": "233019",
"city": "Nairobi",
"state": "SH",
"country": "KE"
}
]
}
}
}'
Response
{
"source": {
"customer": {
"identifier": "user5467890-33333_2",
"firstname": "John",
"middlename": "Freeman",
"lastname": "Doe",
"msisdn": "23380745678491444",
"address": [
{
"line1": "1234 hamptons",
"line2": "hillsbay",
"city": "Nairobi",
"state": "SH",
"country": "KE",
"postalcode": "233019"
}
],
"uniquecode": "SBT_10LY2889"
}
}
}

Get Customer

curl --location --request GET 'https://stg-backend.cgseerapps.com/api/v1/payout/customer?identifier=user5467890-33333_1' \
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f'

Modify Customer

curl --location --request PUT 'https://stg-backend.cgseerapps.com/api/v1/payout/customer' \
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f' \
--header 'Content-Type: application/json' \
--data-raw '{
"source": {
"customer": {
"firstname": "John",
"middlename": "Freeman",
"lastname": "Doe",
"msisdn": "23380745678491444",
"identifier": "user5467890-33333_2",
"address": [
{
"line1": "1234 hamptons",
"line2": "hillsbay",
"postalcode": "233019",
"city": "Nairobi",
"state": "SH",
"country": "KE"
}
]
}
}
}'
Response
{
"source": {
"customer": {
"identifier": "user5467890-33333_2",
"firstname": "John",
"middlename": "Freeman",
"lastname": "Doe",
"msisdn": "23380745678491444",
"address": [
{
"line1": "1234 hamptons",
"line2": "hillsbay",
"city": "Nairobi",
"state": "SH",
"country": "KE",
"postalcode": "233019"
}
],
"uniquecode": "SBT_10LY2889"
}
}
}
Last modified 1yr ago
Copy link
On this page
Base URL
Authentication
Add Customer Card
Get all Customer Cards
Get Customer Card
Detele Customer Card
Fund Customer Card
Get Fund Customer Card Status
Add Customer
Get Customer
Modify Customer