Visa Direct
Payout API for West Africa

Base URL

1
https://stg-backend.cgseerapps.co
Copied!

Authentication

Request

1
cURL:
2
curl --location --request POST 'https://stg-backend.cgseerapps.com/api/v1/payout/authenticate' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"publickey": "publickey1",
6
"privatekey": "privatekey1"
7
}'
Copied!

Response

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

Add Customer Card

Request
1
curl --location --request POST 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card' \
2
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"source": {
6
"customer": {
7
"card": [
8
{
9
"id": "card1234555555_122m",
10
"scheme": "VISA"
11
}
12
]
13
}
14
}
15
}'
Copied!
Response
1
{
2
"code": "success",
3
"message": "successful",
4
"transaction": {},
5
"source": {
6
"customer": {
7
"cards": [
8
{
9
"scheme": "VISA",
10
"id": "card1234555555_122m",
11
"uniquecode": "c82d514579c24056a7e21032b82bf1c5"
12
}
13
]
14
}
15
}
16
}
Copied!

Get all Customer Cards

1
curl --location --request GET 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card' \
2
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f'
Copied!
Response
1
{
2
"code": "success",
3
"message": "successful",
4
"source": {
5
"customer": {
6
"cards": [
7
{
8
"id": "card1234555555_1",
9
"uniquecode": "529c9c64f5a44f5599bff7aeecf43487",
10
"added": "2021-09-06 08:47:22.0"
11
},
12
{
13
"id": "card1234555555_12",
14
"uniquecode": "65d126b02fa44fa6b1de624151d2c652",
15
"added": "2021-09-06 08:48:33.0"
16
},
17
{
18
"id": "card1234555555_121m",
19
"uniquecode": "4531dcaf3d654c38b5f5ef402a339667",
20
"added": "2021-09-06 14:50:07.0"
21
},
22
{
23
"id": "card1234555555_121mm",
24
"uniquecode": "6aa04b64ad594333bae39ca45f23f8e5",
25
"added": "2021-09-06 15:03:39.0"
26
},
27
{
28
"id": "card1234555555_121dmm",
29
"uniquecode": "c56ebf8e03b94b15a30964a66693fe53",
30
"added": "2021-09-06 15:05:32.0"
31
},
32
{
33
"id": "card12345d55555_121m",
34
"uniquecode": "79ce42c54fd24f0f83b2efe6f33eafea",
35
"added": "2021-09-07 07:24:05.0"
36
},
37
{
38
"id": "card12345d55555_121em",
39
"uniquecode": "6ac7e5ee261045e88558941136b28ada",
40
"added": "2021-09-07 07:28:03.0"
41
},
42
{
43
"first6": "455616",
44
"last4": "9090",
45
"id": "card1234b5d5k5555_121m",
46
"uniquecode": "3e007dc819bb43c6931e479e69c9497a",
47
"added": "2021-09-07 13:13:29.0"
48
},
49
{
50
"id": "card1234b5de5k5555_121m",
51
"uniquecode": "703d60795be54590afd84af6ff99f5dd",
52
"added": "2021-09-07 14:32:15.0"
53
},
54
{
55
"id": "card1234555555_122m",
56
"uniquecode": "c82d514579c24056a7e21032b82bf1c5",
57
"added": "2021-09-09 16:54:34.0"
58
}
59
]
60
}
61
}
62
}
63
Copied!

Get Customer Card

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

Detele Customer Card

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

Fund Customer Card

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

Get Fund Customer Card Status

1
curl --location --request GET 'https://stg-backend.cgseerapps.com/api/v1/payout/customer/user5467890-33333_1/card/card1234555555_1?reference=M1603t798eg9106n10m_y124' \
2
--header 'Authorization: Bearer e808dc00-de36-305f-ba15-5caffdc33a82'
Copied!
Response
1
{
2
"code": "S20",
3
"message": "Transaction is pending",
4
"transaction": {
5
"reference": "M1603t798eg9106n10m_y124",
6
"linkingreference": "SEERBITITX442514021631205756428"
7
},
8
"order": {
9
"amount": "10.0000",
10
"currency": "NGN"
11
},
12
"source": {
13
"customer": {
14
"cards": [
15
{
16
"id": "card1234555555_1",
17
"uniquecode": "529c9c64f5a44f5599bff7aeecf43487",
18
"added": "2021-09-06 08:47:22.0"
19
}
20
]
21
}
22
}
23
}
24
Copied!

Add Customer

1
curl --location --request POST 'https://stg-backend.cgseerapps.com/api/v1/payout/customer' \
2
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"source": {
6
"customer": {
7
"firstname": "John",
8
"middlename": "Freeman",
9
"lastname": "Doe",
10
"msisdn": "23380745678491444",
11
"identifier": "user5467890-33333_2",
12
"address": [
13
{
14
"line1": "1234 hamptons",
15
"line2": "hillsbay",
16
"postalcode": "233019",
17
"city": "Nairobi",
18
"state": "SH",
19
"country": "KE"
20
}
21
]
22
}
23
}
24
}'
25
Copied!
Response
1
{
2
"source": {
3
"customer": {
4
"identifier": "user5467890-33333_2",
5
"firstname": "John",
6
"middlename": "Freeman",
7
"lastname": "Doe",
8
"msisdn": "23380745678491444",
9
"address": [
10
{
11
"line1": "1234 hamptons",
12
"line2": "hillsbay",
13
"city": "Nairobi",
14
"state": "SH",
15
"country": "KE",
16
"postalcode": "233019"
17
}
18
],
19
"uniquecode": "SBT_10LY2889"
20
}
21
}
22
}
23
Copied!

Get Customer

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

Modify Customer

1
curl --location --request PUT 'https://stg-backend.cgseerapps.com/api/v1/payout/customer' \
2
--header 'Authorization: Bearer 0af591ce-522c-345d-a23b-5b9222011b1f' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"source": {
6
"customer": {
7
"firstname": "John",
8
"middlename": "Freeman",
9
"lastname": "Doe",
10
"msisdn": "23380745678491444",
11
"identifier": "user5467890-33333_2",
12
"address": [
13
{
14
"line1": "1234 hamptons",
15
"line2": "hillsbay",
16
"postalcode": "233019",
17
"city": "Nairobi",
18
"state": "SH",
19
"country": "KE"
20
}
21
]
22
}
23
}
24
}'
25
Copied!
Response
1
{
2
"source": {
3
"customer": {
4
"identifier": "user5467890-33333_2",
5
"firstname": "John",
6
"middlename": "Freeman",
7
"lastname": "Doe",
8
"msisdn": "23380745678491444",
9
"address": [
10
{
11
"line1": "1234 hamptons",
12
"line2": "hillsbay",
13
"city": "Nairobi",
14
"state": "SH",
15
"country": "KE",
16
"postalcode": "233019"
17
}
18
],
19
"uniquecode": "SBT_10LY2889"
20
}
21
}
22
}
23
Copied!
Last modified 1mo ago