createAccount(V7)

Description

The createAccount request will create new Duma Pay account, and will try to verify credit card by charging 1 USD

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

Variables to send:

Parameter	Data type	Description
Request	Text	createAccount	Mandatory
CompanyToken	Token	Token you got from 3G to operate this API	Mandatory
CustomerEmail	Text	Customer Email address	Mandatory
CustomerFirstName	Text	Customer first name	Mandatory
CustomerLastName	Text	Customer last name	Mandatory
CustomerPhone	Text	Customer phone number	Mandatory
CustomerDialCode	ISO code	Customer country ISO 2 letter code http://en.wikipedia.org/wiki/ISO_3166-1	Mandatory
CustomerPassword	Text	6 chars minimum. Allows characters like !@#$%&()?	Optional
CustomerAddress	Text	Customer address	Optional
CustomerCity	Text	Customer city	Optional
CustomerCountry	ISO code	Customer country ISO 2 letter code http://en.wikipedia.org/wiki/ISO_3166-1	Optional
CustomerZip	Text	Customer zip code	Optional
`CustomerVerify`	Text	Verify “mobile” or “creditCard” (Default: none)	Optional
CustomerCreditCard	Text	Customer credit card number	Mandatory/Optional if `CustomerVerify` is creditCard
CustomerExpiry	Text	Customer credit card expiry date (MM/YY)	Mandatory/Optional if `CustomerVerify` is “creditCard”
CustomerCvv	Text	Customer credit card CVV	Mandatory/Optional if `CustomerVerify` is “creditCard”
CustomerGlobalAccount	Bool	Verify credit card via global account (default 0)	Optional
CustomerHolderName	Text	Customer credit card holder name	Mandatory/Optional if `CustomerVerify` is “creditCard”
CustomerThreeD	XML (String)	Customer credit card 3D data (if need verify 3D credit card )	Optional
`CustomerMno`	Text	MNO for verify payment	Mandatory/Optional if `CustomerVerify` is “mobile”
`CustomerMnoCountry`	Text	MNO country, for example: “Kenya“	Mandatory/Optional if `CustomerVerify` is “mobile”
`CustomerMnoPhone`	Text	Phone number for mobile payment	Mandatory/Optional if `CustomerVerify` is “mobile”

3D Params (CustomerThreeD)

Parameter	Data type	Description
`Enrolled`	Text	3D param, mandatory for PG3D, MIGS3D	Optional
`Paresstatus`	Text	3D param, mandatory for PG3D, MIGS3D(`vpc_3DSstatus`)	Optional
`Eci`	Text	3D param, mandatory for all terminal types	Mandatory
`Xid`	Text	3D param, mandatory for all terminal types	Mandatory
`Cavv`	Text	3D param, mandatory for all terminal types	Mandatory
`Signature`	Text	3D param, mandatory for PG3D	Optional
`Veres`	Text	3D param, mandatory for MPGS3D, MIGS3D, MPGS3DAirlines	Optional
`Pares`	Text	3D param, mandatory for MPGS3D, MPGS3DAirlines	Optional

Request example:

Request example creditCard verify

<?xml version="1.0" encoding="utf-8"?>
<API3G>
  <CompanyToken>90EC1DA4-A7C5-432C-930C-098715D3130E</CompanyToken>
  <Request>createAccount</Request>
  <CustomerVerify>creditCard</CustomerVerify>
  <CustomerEmail>test@directpay.online</CustomerEmail>
  <CustomerPassword>12345678</CustomerPassword>
  <CustomerFirstName>Josh</CustomerFirstName>
  <CustomerLastName>Grinberg</CustomerLastName>
  <CustomerAddress>Rose Avenue 14</CustomerAddress>
  <CustomerCity>Nairobi</CustomerCity>
  <CustomerCountry>KE</CustomerCountry>
  <CustomerDialCode>KE</CustomerDialCode>
  <CustomerPhone>0553231231</CustomerPhone>
  <CustomerZip>762132</CustomerZip>
  <CustomerCreditCard>4111111111111111</CustomerCreditCard>
  <CustomerExpiry>1225</CustomerExpiry>
  <CustomerCvv>123</CustomerCvv>
  <CustomerHolderName>Josh Grinberg</CustomerHolderName>
  <CustomerGlobalAccount>1</CustomerGlobalAccount>
  <CustomerThreeD>
      <Enrolled>fkf></Enrolled>
      <Paresstatus>Y</Paresstatus>
      <Eci>05</Eci>
      <Xid>DYYVcrwnujRMnHDy1wlP1Ggz8w0=</Xid>
      <Cavv>mHyn+7YFi1EUAREAAAAvNUe6Hv8=</Cavv>
      <Signature>_</Signature>
      <Veres>AUTHENTICATION_SUCCESSFUL</Veres>
      <Pares>eAHNV1mzokgW\/is</Pares>
  </CustomerThreeD>
</API3G>

Request example mobile verify

<?xml version="1.0" encoding="utf-8"?>
<API3G>
  <CompanyToken>90EC1DA4-A7C5-432C-930C-098715D3130E</CompanyToken>
  <Request>createAccount</Request>
  <CustomerVerify>mobile</CustomerVerify>
  <CustomerEmail>test@directpay.online</CustomerEmail>
  <CustomerPassword>12345678</CustomerPassword>
  <CustomerFirstName>Josh</CustomerFirstName>
  <CustomerLastName>Grinberg</CustomerLastName>
  <CustomerAddress>Rose Avenue 14</CustomerAddress>
  <CustomerCity>Nairobi</CustomerCity>
  <CustomerCountry>KE</CustomerCountry>
  <CustomerDialCode>KE</CustomerDialCode>
  <CustomerPhone>0553231231</CustomerPhone>
  <CustomerZip>762132</CustomerZip>
  <CustomerMno>SafaricomC2B</CustomerMno>
  <CustomerMnoCountry>Kenya</CustomerMnoCountry>
  <CustomerMnoPhone>25412345678</CustomerMnoPhone>
</API3G>

Respond:

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

Parameter	Data type	Description
Code	Number	Resault code
Explanation	Text	Free text of the response
customerToken	Token	Unique customer token to operate payments
subscriptionToken	Token	Unique Subscription Token to operate payments
cardType	Text	Credit card brand
cardLast4	Text	Credit card last 4 digits
`MnoPhone`	Text	Payment phone number
`MnoCountry`	`Text`	Mno Country for verify number
`Mno`	Text	Mno for verify number

Respond example:

response example creditCard verify

<?xml version="1.0" encoding="UTF-8"?>
<API3G>
    <Code>000</Code>
	<Explanation>Successfully created account and verified credit card</Explanation>
	<customerToken>71327DB9-BCD1-4CC4-A062-2BBECF3CBCC0</customerToken>
	<subscriptionToken>338182F9-03FD-4EE4-9B66-7B40746090F1</subscriptionToken>
	<cardType>Visa</cardType>
	<cardLast4>1111</cardLast4>
</API3G>

response example mobile verify

<?xml version="1.0" encoding="UTF-8"?>
<API3G>
    <Code>000</Code>
	<Explanation>Successfully created mobile account</Explanation>
	<customerToken>71327DB9-BCD1-4CC4-A062-2BBECF3CBCC0</customerToken>
	<subscriptionToken>338182F9-03FD-4EE4-9B66-7B40746090F1</subscriptionToken>
	<MnoPhone>25412345678</MnoPhone>
	<MnoCountry>Kenya</MnoCountry>
	<Mno>SafaricomC2B</Mno>
</API3G>

Error response example:

<?xml version="1.0" encoding="UTF-8"?>
<API3G>
    <Code>903</Code>
	<Explanation>Terminal was not found . Please try again or contact to support team</Explanation>
</API3G>