pullAccount(V7)

Description

The pullAccount request will retrieve register customer saved tokens and mobile options

URL: https://secure1.sandbox.directpay.online/API/v7/index.php

Variables to send:

Parameter

Data type

Description



Parameter

Data type

Description



 Request

 Text

 pullAccount

Mandatory

CompanyToken

Token

Token you got from 3G to operate this API

Mandatory

customerToken

Token

Customer token, retrieved from 'createAccount' API

Mandatory

 

Request example:

<?xml version="1.0" encoding="utf-8"?> <API3G> <CompanyToken>90EC1DA4-A7C5-432C-930C-098715D3130E</CompanyToken> <Request>pullAccount</Request> <customerToken>D570C45A-9F39-4402-8D87-4593D2C28405</customerToken> </API3G>

 

Respond:

The server will respond for the pullAccount request according to the following results:

Parameter

Data type

Description

Parameter

Data type

Description

Code

Number

Result code

Explanation

Text

Free text of the response

customerToken

Token

Unique customer token to operate payments

subscriptionToken

Token

Unique payment token to operate payments

paymentType

Text

Payment option type

paymentLast4

Text

Last 4 digits of card or phone number

customerMno

Text

Mobile Payment MNO

customerMnoCountry

Text

Mobile Payment Country

customerMnoPhone

Text

Mobile Payment Phone

customerMnoLogo

Text

MNO Logo

 

Respond example:

<?xml version="1.0" encoding="UTF-8"?> <API3G> <Code>000</Code> <Explanation>Success</Explanation> <customerToken>D570C45A-9F39-4402-8D87-4593D2C28405</customerToken> <paymentOptions> <option> <subscriptionToken>798A29B4-EAB0-40B8-B46E-90925239E119</subscriptionToken> <paymentType>Visa</paymentType> <paymentLast4>1111</paymentLast4> <paymentDefault>0</paymentDefault> </option> <option> <subscriptionToken>E4EF743C-7751-4A34-AC0D-0AC02DA139FE</subscriptionToken> <paymentType>Mobile</paymentType> <customerMno>SafaricomC2B</customerMno> <customerMnoCountry>Kenya</customerMnoCountry> <customerMnoPhone>596969544</customerMnoPhone> <customerMnoLogo>payv2/assets/img/mpesa.png</customerMnoLogo> </option> <option> <subscriptionToken>A61CA582-A222-4A33-8BC2-523808BE29A1</subscriptionToken> <paymentType>American Express</paymentType> <paymentLast4>8431</paymentLast4> <paymentDefault>0</paymentDefault> </option> </paymentOptions> </API3G>