Astropay Bank Transfer Withdrawal

Provider Astropay (now Directa24) offers bank transfer withdrawal for various countries in Latin America.

The following method IDs are covered in this section:

ID	Name	Credit/Debit State
265	AstropayBankTransferWithdrawal	WithdrawnByProvider

Payment method interaction type: Sychronous execution (see Interaction Types).

Payments are submitted to Directa24 - when being submitted successfully, the state is updated to InitiatedByProvider, else to WithdrawErrorReportedByProvider for an error or to RefusedByProvider for a rejected payment. In the later case, the values ProviderErrorMessage and _ProviderErrorCode_are logged.

Submitted payments are sent by Astropay (D24) to the bank. Once they are confirmed by the bank, Astropay sends a notification to PXP Financial. PXP Financial queries the Astropay (D24) system for the status of the payment and update the payment state on PXP Financial side.

Redirect Integration

Currently not supported.

Backend2BackendIntegration

The following table contains the fields to be sent in the initiatePaymentRequest.specificPaymentAccountData xml section:

key (value type, account type, required)	value
CurrencyCode (string)	currency code, e.g. BRL
BankCountryCode2 (string)	country code, e.g. BR
AccountNumber (string)	Bank account number
BranchCode (string)	bank branch code
BankSortCode (string)	Bank code
AccountOwnerAddress (string)	Address of bank account owner
AccountOwner (string)	Account owner name
AccountType (string)	Account type value (see below)

The following parameters can be provided in initiatePaymentRequest.specificPaymentData:

key (value type, account type, required)	value
PaymentProviderID (Int)	Provider ID - default value 152
UserFirstName (string)	Beneficiary´s first name
UserLastName (string)	Beneficiary´s last name

The following parameters have to passed in initiatePaymentRequest.UserData:

key (value type, account type, required)	value
identificationNumber (string)	identification number
identificationNumberType (string)	identification number type

Overview of required parameters:

Field	Argentina	Brazil	Chile	Columbia	Mexico	Peru	Uruguay
BankSortCode	NA	Mandatory (see validations); send either the bank code or the ISPB	Mandatory	Mandatory (see validations)	mandatory only if bank account length is 16 (debit card)	NA	Mandatory (see validations)
BranchCode	NA	Mandatory (see validations)	NA	NA	NA	NA	Mandatory (see validations)
AccountNumber	Mandatory (CBU) (see validations)	Mandatory (see validations)	Mandatory	Mndatory	Mandatory (Clabe or Debit card; see validations)	Mandatory (CCI) (see validations)	Mandatory (see validations)
AccountType	NA	Mandatory (see validations)	Mandatory (see validations)	Mandatory (see validations)	NA	Mandatory (see validations)	mandatory (only if bank sort code is BROU)
UserFirstName	Mandatory	Mandatory	Mandatory	Mandatory	Mandotry	Mandatory	Mandatory
UserLastName	NA (optional)	Mandatory	Mandatory	Mandatory	Mandatory	Mandatory	Mandatory
IdentificationNumber	Mandatory (see validations)	Mandatory (see validations)	Mandatory (see validations)	Mandatory (see validations)	Mandatory (see validations)		Mandatory (see validations)
IdentificationNumberType	NA (optional)	NA (optional)	NA (optional)	Mandatory (see validations)			NA
currency	ARS	BRL	CLP	COP	MXN	PEN	UYU
Street (in User)	NA (optional)	NA (optional)	NA (optional)	Mandatory	NA (optional)	NA (optional)	NA (optional)
eMail (in User)	NA (optional)	NA (optional)	NA (optional)	mandatory	NA (optional)	NA (optional)	NA (optional)

Data Validation

📘
Account Type for Brazil
The AccountType value for Brazil is mandatory. The following values apply:
'1' - For Individual Savings Account - account type 'S' is sent to Astropay
'2'- For Corporate Savings Account - account type 'S' is sent to Astropay
'3' - For Individual Checking Account - account type 'C' is sent to Astropay
'4' - For Corporate Checking Account - account type 'C' is sent to Astropay
Alternatively the values 'C' or 'S' can be passed in the field AccountType for Astropay.

📘
AccountType for other countries

Chile: C for checking account, S for savings account and V for vista

Columbia: C for checking and S for savings; for Efecty please send accountType S

Peru: M (Cuenta Maestra)

📘
Identification Number Validation

Brazil:

CPF: Length 11; validate verifier-digits

CNPJ : Length between 12 and 14; validate verifier-digitals

Chile: ID / RUN / RUT: Length 8 or 9

Colombia:

CC: Numeric. Length between 6 and 10 inclusive

NIT: Numeric. Length between 8 and 15

CE: Numeric. Length lower than 6 and 10 inclusive

PASS: Length between 6 and 10 inclusive
*CE (for PEP): Numeric. Length 15.

Peru:

DNI: length between 8 and 9

RUC: length 11

CE (Carnet Extranjeria): Numeric. Lenght 9

PASS (Passport): length 12

Mexico: CURP /RFC / IFE / PASS / Residencia: Length between 8 and 18 inclusive

Argentina:

DNI: Numeric, Length 7-9

CUIT/CUIL: Numeric, Length between 7 and 9 inclusive or equal to 11

Uruguay:

CI: Numeric. Length between 9 and 13 inclusive

Postal Code validations:

Country	Regex	Example
Argentina	^\d{4}\|[A-Za-z]\d{4}([a-zA-Z]{3})?$	A1234ABC
Brazil	^\d{5}[\s-/]?\d{3}$	12345-678
Chile	^\d{3}[\s-/]?\d{4}$	123-4567
Columbia	^\d{5,6}$	12345
Mexico	^\d{5}$	12345
Peru	^\d{5}$	12345
Uruguay	^\d{5}$	12345

Bank codes:

Code	Bank name
001	Banco de Chile
016	Banco Credito e Inversiones
053	Banco Ripley
052	Deutsche Bank
054	Radobank Chile
027	Corpbanca
028	Banco Bice
049	Banco Security
031	HSBC Bank
046	ABN Amor Bank Chile
037	Banco Santander- Santiago
057	Banco Paris
507	Banco del Desarrollo
014	Scotiabank Sud Americano
056	Banco Penta
055	Consorcio
012	Banco del Estado de Chile
009	Banco Internacional
039	Banco Itau
051	Banco Falabella
504	BBVA Banco Bhif

Code	Bank name
003	Interbank
800	Caja Metropolitana de Lima
805	Caja Municipal de Ahorro y Crédito Sullana
801	Caja Municipal de Ahorro y Crédito Piura SAC
011	BBVA Continental
002	Banco de Crédito del Perú
808	Caja Municipal de Ahorro y Crédito Huancayo
806	Caja Municipal de Ahorro y Crédito Cuzco
803	Caja Municipal de Ahorro y Crédito Arequipa
802	Caja Municipal de Ahorro y Crédito Trujillo
007	Citibank
054	Banco Falabella
053	Banco GNB Perú S.A.
049	Mi Banco
043	Crediscotia Financiera
038	Banco Interamericano de Finanzas (BIF)
035	Banco Financiero
023	Banco de Comercio
018	Banco de la Nación
009	Scotiabank
056	Santander

Code	Bank name
615	MERRILL LYNCH
623	SKANDIA
622	OACTIN
616	FINAMEX
617	VALMEX
620	PROFUTURO
619	MAPFRE
621	CB ACTINVER
618	UNICA
614	ACCIVAL
140	CONSUBANCO
141	VOLKSWAGEN
143	CIBANCO
166	BANSEFI
168	HIPOTECARIA FEDERAL
145	BBASE
600	MONEXCB
601	GBM
602	MASARI
605	VALUE
606	ESTRUCTURADORES
607	TIBER
608	VECTOR
610	B&B
139	UBS BANK
634	FINCOMUN
646	STP
647	TELECOMM
648	EVERCORE
649	SKANDIA
651	SEGMTY
653	KUSPIT
655	SOFIEXPRESS
656	UNAGRA
659	OPCIONES EMPRESARIALES DEL NOROESTE
670	LIBERTAD
901	CLS
642	REFORMA
640	CB JPMORGAN
638	AKALA
626	CBDEUTSCHE
627	ZURICH
628	ZURICHVI
652	ASEA
629	SU CASITA
630	CB INTERCAM
631	CI BOLSA
632	BULLTICK CB
633	STERLING
636	HDI SEGUROS
637	ORDER
902	INDEVAL
9	BANOBRAS
42	MIFEL
44	SCOTIABANK
58	BANREGIO
59	INVEX
60	BANSI
62	AFIRME
72	BANORTE
102	THE ROYAL BANK
37	INTERACCIONES
36	INBURSA
2	BANAMEX
12	BBVA BANCOMER
14	SANTANDER
19	BANJERCITO
21	HSBC
30	BAJIO
32	IXE
6	BANCOMEXT
103	AMERICAN EXPRESS
106	BAMSA
128	AUTOFIN
129	BARCLAYS
130	COMPARTAMOS
131	BANCO FAMSA
132	BMULTIVA
133	ACTINVER
134	WALMART
135	NAFIN
136	INTERBANCO
137	BANCOPPEL
138	ABC CAPITAL
127	AZTECA
124	DEUTSCHE
108	TOKYO
126	CREDIT SUISSE
110	JP MORGAN
112	BMONEX
113	VE POR MAS
116	ING

001 BANCO DE BOGOTÁ
002 BANCO POPULAR
006 ITAÚ - Antes CORPBANCA
007 BANCOLOMBIA
008 ABN AMRO
009 CITIBANK
010 HSBC
012 BANCO SUDAMERIS
013 BBVA
014 ITAÚ (HELM)
019 BANCO COLPATRIA
023 BANCO DE OCCIDENTE
032 BANCO CAJA SOCIAL BCSC
040 BANCO AGRARIO
051 BANCO DAVIVIENDA
052 BANCO AV VILLAS
058 BANCO PROCREDIT
060 ANCO PICHINCHA
061 BANCOOMEVA
062 BANCO FALABELLA S.A
065 SANTANDER
076 COOPCENTRAL S.A
283 COOPERATIVA FINANCIERA DE ANTIOQUIA
289 COTRAFA COOPERATIVA FINANCIERA
292 CONFIAR
296 FINANCIERA JURISCOOP
1507 NEQUI
1551 DAVIPLATA

Notice that the bank code is not mandatory for Argentina.

Bank name	Code
A.B.N Amro Bank	005
American Express Bank Ltd	295
Bacs Banco de Credito Y Securitizacion	340
Banca Nazionale Del Lavoro	265
Banco B. I. Creditanstalt	147
Banco Banex	297
Banco Bradesco Argentina	336
Banco Cetelem Argentina	331
Banco CMF	319
Banco Cofidis	335
Banco Columbia	389
Banco Comafi	299
Banco Credicoop Coop. L	191
Banco de Corrientes	094
Banco de Formosa	315
Banco de Galicia Y Buenos Aires	007
Banco de Inversion Y Comercio Exterior	300
Banco de La Ciudad de Buenos Aires	029
Banco de La Nacion Argentina	011
Banco de La Pampa Sociedad de Economia M	093
Banco de La Provincia de Buenos A	014
Banco de La Provincia de Cordoba	020
Banco de La Republica Oriental Del Uruguay	269
Banco de San Juan	045
Banco de Santa Cruz	086
Banco de Santiago Del Estero	321
Banco de Servicios Financieros	332
Banco de Servicios Y Transacciones	338
Banco de Valores	198
Banco Del Chubut	083
Banco Del Sol	310
Banco Del Tucuman	060
Banco Do Brasil	046
Banco Empresario de Tucuman Coop. L	137
Banco Finansur	303
Banco Hipotecario	044
Banco Itau Buen Ayre	259
Banco Julio	305
Banco Macro Bansud	285
Banco Mariva	254
Banco Mercurio	293
Banco Meridian	281
Banco Municipal de Ros	065
Banco Patagonia Sudameris	034
Banco Piano	301
Banco Privado de Inversiones	306
Banco Provincia de Tierra Del Fuego	268
Banco Provincia Del Neuquen	097
Banco Regional de Cuyo	079
Banco Rio de La Plata	072
Banco Roela	247
Banco Saenz	277
Banco Societe Generale	027
Bank Of America, National Associa	262
Bankboston, National Associa	015
BBVA Banco Frances	017
Bnp Paribas	266
Citibank	016
Deutsche Bank	325
HSBC Bank Argentina	150
Ing Bank	294
J P Morgan Chase Bank Sucursal Buenos Aires	165
Lloyds Tsb Bank	010
M. B. A. Banco de Inversiones	312
Nuevo Banco Bisel	388
Nuevo Banco de Entre Rios	386
Nuevo Banco de La Rioja	309
Nuevo Banco de Santa Fe	330
Nuevo Banco Del Chaco	311
Nuevo Banco Industrial de Azul	322
Nuevo Banco Suquia	387
Rci Ba	339
The Bank Of Tokyo - Mitsubishi	018

Bank	Code
BANCO ABN AMRO S.A.	075
Cooperativa Central de Crédito Urbano-CECRED	085
BANCO DA AMAZONIA S.A.	003
BANCO DO NORDESTE DO BRASIL S.A.	004
BANCO BONSUCESSO S.A.	218
BANCO BRADESCO S.A.	237
BANCO DO BRASIL S.A.	001
BANCO DE BRASILIA S.A. - BRB	070
CAIXA ECONOMICA FEDERAL - CEF	104
CITIBANK N.A.	477
BANCO COOPERATIVO DO BRASIL S/A - BANCOOB	756
BANCO DAYCOVAL S.A.	707
BANESTES S.A. BANCO DO ESTADO DO ESPIRITO SANTO	021
BANCO DO ESTADO DO PARA S.A. - BANPARA	037
BANCO DO ESTADO DO RIO GRANDE DO SUL S.A. - BANRISUL	041
BANCO DO ESTADO DE SERGIPE S.A. - BANESE	047
HSBC BANK BRASIL S.A. - BANCO MULTIPLO	399
ITAU UNIBANCO S.A.	341
BANCO MERCANTIL DO BRASIL S.A.	389
BANCO MODAL S.A.	746
BANCO SAFRA S.A.	422
BANCO SANTANDER BRASIL S.A.	033
BANCO COOPERATIVO SICREDI S.A.	748
BANCO INTER	077
BANCO SOFISA	637
BANCO NEON	735
NU PAGAMENTOS	260
Cooperativa Central de Crédito Urbano-CECRED	085
BANCO AGIPLAN S.A.	121
Confederação Nacional das Cooperativas Centrais Unicred	136
BANCO ORIGINAL	212
Banco Votorantim S.A.	655
BANCO CITIBANK	745
PagSeguro Internet S.A.	290
BANCO BMG S.A	318
BANCO C6 S.A.	336

Bank account validations Columbia

BankName	Bank Code	Format	Regex	Example
Nequi	1507	Customer´s mobile phone	^[\s\S]{1,20}$	1234567890
Daviplata	1551	Customer´s mobile phone	^[\s\S]{1,20}$
Efecty	10003
Others	-	Numeric	^\d{8,19}$	1234567890123

Branch code (Brazil):

Bank	Format	Example
ABN Amro	Format: XXXX where X are digits. The number of digits can't exceed 5	1234
Banco do Brasil	Not permitted values: 001, 051. Format: XXXX-D or XXXXD where X are digits and D are digits or a 'X'. The number of digits may change, but can't exceed 5 digits	12345, 1234-5, 1234-X, 1234X
Santander	Not permitted values: 033. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits	12345, 1234-5
Itau	Not permitted values: 001, 341, 500. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits	12345, 1234-5
Caixa	Not permitted values: 013, 023, 104. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits	12345, 1234-5
Bradesco	Not permitted values: 237. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits	12345, 1234-5
Others	Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits	12345, 1234-5

Requests/Responses

Example initiatePaymentRequest:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <merchantID>B2BTestMerchant</merchantID>
  <shopID>AstropayCardBankTransferWithdrawalShop</shopID>
  <merchantTransactionID>5f366a56-a394-4ab2-aac3-f4174ba716d8-21</merchantTransactionID>
  <paymentMethodID>265</paymentMethodID>
  <amount currencyCode="BRL">10.01</amount>
  <userID>12eadca3-0d87-4144-a75e-10ea70</userID>
  <userData>
    <username>061bb617-bbe8-4aa4-b896-8b06949e653b</username>
    <firstname>Edson</firstname>
    <lastname>Arantes do Nascimento</lastname>
    <currencyCode xsi:nil="true" />
    <languageCode xsi:nil="true" />
    <email xsi:nil="true" />
    <address>
      <street>Street</street>
      <houseName xsi:nil="true" />
      <houseNumber>1</houseNumber>
      <houseNumberExtension xsi:nil="true" />
      <postalCode>11300</postalCode>
      <city>Sao Paulo</city>
      <state xsi:nil="true" />
      <countryCode2>BR</countryCode2>
      <telephoneNumber>099123456</telephoneNumber>
    </address>
    <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
    <identificationNumber>1234567890</identificationNumber>
    <identificationNumberType>1</identificationNumberType>
  </userData>
  <userIP>127.0.0.1</userIP>
  <userSessionID>a59a22cd-6178-4125-b966-188ff1a61181</userSessionID>
  <creationTypeID>1</creationTypeID>
  <specificPaymentData>
    <data xsi:type="keyStringValuePair">
      <key>UserFirstname</key>
      <value>John</value>
    </data>
    <data xsi:type="keyStringValuePair">
      <key>UserLastname</key>
      <value>Doe</value>
    </data>
    <data xsi:type="keyIntValuePair">
      <key>PaymentProviderID</key>
      <value>152</value>
    </data>
  </specificPaymentData>
  <paymentAccount>
    <specificPaymentAccountData>
      <data xsi:type="keyStringValuePair">
        <key>CurrencyCode</key>
        <value>BRL</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>BankCountryCode2</key>
        <value>BR</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountNumber</key>
        <value>88365484</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>BranchCode</key>
        <value>7197</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountOwner</key>
        <value>Edson Arantes do Nascimento</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>BankSortCode</key>
        <value>033</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountOwnerAddress</key>
        <value>1225 Bonavita St.</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>1</value>
      </data>
    </specificPaymentAccountData>
  </paymentAccount>
</initiatePaymentRequest>

<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<merchantID>YourShop</merchantID>
	<shopID>YourMerchant</shopID>
	<merchantTransactionID>59715590-9</merchantTransactionID>
	<paymentMethodID>265</paymentMethodID>
	<amount currencyCode="MXN">1.00</amount>
	<userID>ygtest</userID>
	<userData>
		<username>ygtest</username>
		<firstname>John</firstname>
		<lastname>Doe</lastname>
		<email>[email protected]</email>
		<address>
			<countryCode2>MX</countryCode2>
		</address>
		<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
	</userData>
	<userIP>179.108.166.2</userIP>
	<userSessionID>59715590</userSessionID>
	<creationTypeID>1</creationTypeID>
	<specificPaymentData>
		<data xsi:type="keyIntValuePair">
			<key>PaymentProviderID</key>
			<value>152</value>
		</data>
	</specificPaymentData>
	<paymentAccount>
		<specificPaymentAccountData>
			<data xsi:type="keyStringValuePair">                                                 
				<key>BankName</key>
				<value>Banco do Brasil</value>
			</data>
			<data xsi:type="keyStringValuePair">                                                 
				<key>BankCountryCode2</key>
				<value>MX</value>
			</data>
			<data xsi:type="keyStringValuePair">                                               
				<key>AccountNumber</key>                                                
				<value>032180000118359719</value>
			</data>
			<data xsi:type="keyStringValuePair">                                                 
				<key>AccountOwner</key>
				<value>DOS SANTOS</value>
			</data>
			<data xsi:type="keyStringValuePair">                                                 
				<key>BankSortCode</key>
				<value>032</value>
			</data>
		</specificPaymentAccountData>
	</paymentAccount>
</initiatePaymentRequest>

<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <merchantTransactionID>59715590-11-27</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="PEN">100.00</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Yusuf</firstname>
             <lastname>Genc</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>PE</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
              <identificationNumber>58324956</identificationNumber>
               <identificationNumberType>DNI</identificationNumberType>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco do Peru</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>PE</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>00159687395013948567</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>113</value>
   </data>
   	<data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>C</value>
      </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>

<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <merchantTransactionID>59715590-11-42</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="PEN">100.00</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Yusuf</firstname>
             <lastname>Genc</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>PE</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
              <identificationNumber>10583249562</identificationNumber>
               <identificationNumberType>RUC</identificationNumberType>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco do Peru</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>PE</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>00159687395013948567</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>113</value>
   </data>
   	<data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>C</value>
      </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>

<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <merchantTransactionID>59715590-1-06</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="CLP">1.00</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Max</firstname>
             <lastname>Muster</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>CL</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
             <identificationNumber>21644285</identificationNumber>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco de Chile</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>CL</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>9795493</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>001</value>
   </data>
	<data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>C</value>
      </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>

<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <merchantTransactionID>59715590-12-11-313</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="COP">1000</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Yusuf</firstname>
             <lastname>Genc</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>CO</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
              <identificationNumber>1058324956</identificationNumber>
              <identificationNumberType>CC</identificationNumberType>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco de Bogota</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>CO</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>0321800001183597</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>001</value>
   </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>


<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <merchantTransactionID>hctest002013514</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="COP">40000</amount>
        <userID>55517534-03</userID>
        <userData>
                                <username>pp_ppboleto7-03</username>
                <firstname>PPPPBOLETOFN</firstname>
                <lastname>PPPPBOLETOLN</lastname>
                <email>[email protected]</email>
                <address>
                        <street>Address</street>
                        <houseName>Address</houseName>
                        <postalCode>447475</postalCode>
                        <state>State</state>
                        <countryCode2>CO</countryCode2>
                        <telephoneNumber>+573104028587</telephoneNumber>
                </address>
                        <dateOfBirth>1940-03-08T00:00:00</dateOfBirth>
                         <identificationNumber>2134567890</identificationNumber>
                        <identificationNumberType>CC</identificationNumberType>
        </userData>

        <userIP>10.8.60.57</userIP>
        <userSessionID>53603061</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
                <data xsi:type="keyStringValuePair">
                        <key>UserFirstname</key>
                        <value>PPPPBOLETOFN</value>
                </data>
                <data xsi:type="keyStringValuePair">
                        <key>UserLastname</key>
                        <value>PPPPBOLETOLN</value>
                </data>
                <data xsi:type="keyStringValuePair">
                        <key>UserCountryCode2</key>
                        <value>CO</value>
                </data>
                <data xsi:type="keyIntValuePair">
                        <key>PaymentProviderID</key>
                        <value>152</value>
                </data>
        </specificPaymentData>
        <paymentAccount>
                <specificPaymentAccountData>
                <data xsi:type="keyStringValuePair">
                <key>CurrencyCode</key>
                <value>COP</value>
               </data> 

			<data xsi:type="keyStringValuePair">
                        <key>BankCountryCode2</key>
                        <value>CO</value>
                        </data>
                        <data xsi:type="keyStringValuePair">
                                <key>BankSortCode</key>
                                <value>10003</value>
                        </data>
                         <data xsi:type="keyStringValuePair">
                                <key>AccountType</key>
                                <value>S</value> 
                        </data>
            </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>

Example initiatePaymentResponse:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>B2BTestMerchant</merchantID>
        <shopID>AstropayCardBankTransferWithdrawalShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>5f366a56-a394-4ab2-aac3-f4174ba716d8-21</merchantTransactionID>
        <paymentID>cf976b7d-3711-441d-b38a-5f8c6a6becd1</paymentID>
        <userID>12eadca3-0d87-4144-a75e-10ea70</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="BRL">10.01</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>60425692-feae-47bb-b699-7b4ae6081c23</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2017-11-09T08:43:33.7735125Z</createdOn>
            <description>OK</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">2.66</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>UserFirstname</key>
                <value>John</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>UserLastname</key>
                <value>Doe</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>cf976b7d-3711-441d-b38a-5f8c6a6becd1</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>e9d14450-20db-4304-b55d-a652953f7976</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>541885ca-1f5b-4f16-be70-62cd9cb973a5</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-9</merchantTransactionID>
        <paymentID>f9b6a33c-831e-4f37-b533-3fc6f6db70da</paymentID>
        <userID>ygtest</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="MXN">1.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>cefcf293-2583-4962-9720-50de184fd70f</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-01T15:34:48.2705465Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">0.06</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2257</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25161</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>e67a3016-a5cb-4986-8210-1d39a68d5943</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-11-27</merchantTransactionID>
        <paymentID>d3f26f44-e30e-4741-a819-853e97be0dfa</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="PEN">100.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>bd938504-0c97-486b-a9e2-bfe91a3784c4</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-02T14:53:55.7424819Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">24.94</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2281</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25185</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchamt</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-11-42</merchantTransactionID>
        <paymentID>98858d51-cc27-49e1-a036-505bf89f137f</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="PEN">100.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>9122d0e4-b161-4474-934b-bc3ebbfa29ff</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-05T09:54:08.7735183Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">24.94</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2288</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25213</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-11-42</merchantTransactionID>
        <paymentID>98858d51-cc27-49e1-a036-505bf89f137f</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="PEN">100.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>9122d0e4-b161-4474-934b-bc3ebbfa29ff</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-05T09:54:08.7735183Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">24.94</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2288</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25213</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-12-11-313</merchantTransactionID>
        <paymentID>b58e1f0a-bde7-4f1e-aad2-4f49ad6331d2</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="COP">1000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>d049f140-1b0e-4c0f-933c-930986d291fd</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2020-01-28T08:27:18.6162134Z</createdOn>
            <description>OK</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">0.39</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>52716f7e-53bb-436a-a547-872e8edf045c</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>3458</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>ba49550b-2769-4ef3-ad1c-e9f04e347f1f</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>hctest002013514</merchantTransactionID>
        <paymentID>0b1129d1-d3fb-45c6-8545-3c933fdc594f</paymentID>
        <userID>55517534-03</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="COP">40000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>10.8.60.57</userIP>
        <state>
            <id>a1f9404e-2007-4dbc-80a8-2258eee49c51</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2024-01-03T09:12:13.9357329Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">15.42</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>UserFirstname</key>
                <value>PPPPBOLETOFN</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>UserLastname</key>
                <value>PPPPBOLETOLN</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>244402</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>20672</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>e4ab9ba8-bb4c-4e92-a5be-f6a5b5206c3e</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

The payment can reach one of the following states in the initiatePaymentResponse:

Payment States	Description
InitiatedByProvider	Intermediate state denoting a successful payment submission at provider
WithdrawalErrorReportedByProvider	Error state due to failed payment submission at provider; errors are logged in the PaymentStateAdditionalDetails fields ProviderErrorCode and ProviderErrorMessage
RefusedByProvider	Error state for a rejected payment; errors are logged in the PaymentStateAdditionalDetails field ProviderReturnCode

Submitted payments are sent by Astropay to the bank. Once they are confirmed by the bank, Astropay sends a notification to PXP Financial. PXP Financial queries the Astropay system for the status of the payment and update the payment state on PXP Financial side.

An AstropayBankTransferWithdrawal payment will have the following flow (described in provider terms and PXP Financial payment service states):

Pending (state InitiatedByProvider) => Delivered (state PendingOnProvider) => Confirmed (state WithdrawnByProvider) or Rejected (state RefusedByProvider).

A payment can also go from Pending (state InitiatedByProvider) or Delivered (state PendingOnProvider) to Cancelled (state Cancelled).

Payment States	Description
PendingOnProvider	A withdrawal payment has been sent to provider ("Delivered"), but not yet processed and it still can be rejected
WithdrawnByProvider	Success state
RefusedByProvider	Error state due to failed processing of payment; errors are logged in the PaymentStateAdditionalDetails fields ProviderErrorCode and ProviderErrorMessage
QueryPaymentStateErrorReportedByProvider	When PXP Financial receives a state change notification from provider Astropay, the state of the payment is being queried against provider. When an error occurs, errors are logged in the PaymentStateAdditionalDetails fields ProviderErrorCode and ProviderErrorMessage

Notifications

The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.

Example handlePaymentStateChangedNotificationRequest:

<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <payment xsi:type="paymentWithPaymentAccount">
    <merchantID>B2BTestMerchant</merchantID>
    <shopID>AstropayCardBankTransferWithdrawalShop</shopID>
    <paymentMethod>
      <key>265</key>
      <value>AstropayBankTransferWithdrawal</value>
    </paymentMethod>
    <merchantTransactionID>17593196-f44f-4b1e-92e8-474d8e88710d</merchantTransactionID>
    <paymentID>c2c83321-1466-4af7-bde3-d84418f9b991</paymentID>
    <userID>12b140b5-35ee-4a83-9f87-9d4405</userID>
    <paymentProvider>
      <key>152</key>
      <value>Astropay</value>
    </paymentProvider>
    <amount currencyCode="BRL">10.0000</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>6ca51370-bac8-42da-8121-1627a34289cd</id>
      <definition>
        <key>20</key>
        <value>WithdrawnByProvider</value>
      </definition>
      <createdOn>2017-09-08T09:58:29.783</createdOn>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderResponseMessage</key>
          <value>Completed</value>
        </detail>
      </paymentStateDetails>
    </state>
    <isExecuted>true</isExecuted>
    <baseAmount currencyCode="EUR">2.6500</baseAmount>
    <paymentDetails>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderExternalID</key>
        <value>c2c83321-1466-4af7-bde3-d84418f9b991</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>BankReferenceID</key>
        <value>513512.04198.5</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderTransactionID</key>
        <value>8ef0c159-966e-43e1-a0ba-62661d72fc47</value>
      </detail>
    </paymentDetails>
    <paymentAccount>
      <paymentAccountID>d52b9f0e-55b3-4011-a5e7-3935c6388958</paymentAccountID>
    </paymentAccount>
  </payment>
</handlePaymentStateChangedNotificationRequest>

Testing instructions

Identification Numbers for Astropay

Country	IdentificationNumber (sample values for testing)	IdentifcationNumberType
Brazil	Test data for CPF or CNPJ here	Do not send any value.
Chile	Test data for RUT here (11 digits)	Do not send any value
Peru	DNI: 58324956 RUC: 48531120453 PASS: 595601234865 CE: 433450978123	Send DNI, RUC, PASS or CE.
Mexico	sending is optional CURP or RFC or IFE number	sending is optional
Columbia	For CC eg. 1058324956	type CC.

Bank account data for Astropay:

Country	AccountNumber	BranchCode	BankSortCode	AccountType
Brazil	88365484	7197		C
Chile	9795493		001	C
Peru	00159687395013948567		113	C
Mexico	032180000118359719		032	-
Columbia	0321800001183597		001

BankTransferWithdrawalReturn

In case a bank transfer withdrawal is returned, then a new payment of type BankTransferWithdrawalReturn is created and merchant is notified.

Sample notification with payment method BankTransferWithdrawal

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
	<payment xsi:type="paymentWithPaymentAccount">
		<merchantID>xxx</merchantID>
		<shopID>xxx</shopID>
		<paymentMethod>
			<key>265</key>
			<value>AstropayBankTransferWithdrawal</value>
		</paymentMethod>
		<merchantTransactionID>e2934084-ce2d-4d57-bd0f-81a0983fbf49</merchantTransactionID>
		<paymentID>de6524a5-44c8-440e-8fb9-bda0ccf59301</paymentID>
		<userID>f782088e-0d3e-402b-9143-359be4</userID>
		<paymentProvider>
			<key>152</key>
			<value>Astropay</value>
		</paymentProvider>
		<amount currencyCode="BRL">10.0300</amount>
		<creationType>
			<key>1</key>
			<value>User</value>
		</creationType>
		<state>
			<id>434bae34-630a-4b6f-9c00-faa0c5c5adf2</id>
			<definition>
				<key>279</key>
				<value>ReturnedByProvider</value>
			</definition>
			<createdOn>2021-04-07T15:40:31.79</createdOn>
			<paymentStateDetails>
				<detail xsi:type="keyStringValuePair">
					<key>ProviderResponseMessage</key>
					<value>Rejected</value>
				</detail>
			</paymentStateDetails>
		</state>
		<isExecuted>true</isExecuted>
		<baseAmount currencyCode="EUR">2.6600</baseAmount>
		<paymentDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderExternalID</key>
				<value>de6524a5-44c8-440e-8fb9-bda0ccf59301</value>
			</detail>
			<detail xsi:type="keyIntValuePair">
				<key>MerchantSettlementCurrencyID</key>
				<value>2</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentID</key>
				<value>de6524a5-44c8-440e-8fb9-bda0ccf59301</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentMerchantTransactionID</key>
				<value>e2934084-ce2d-4d57-bd0f-81a0983fbf49</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentMethodID</key>
				<value>265</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentMethodName</key>
				<value>AstropayBankTransferWithdrawal</value>
			</detail>
		</paymentDetails>
		<paymentAccount>
			<paymentAccountID>1d9ca158-38ce-4270-8d53-cbab137254df</paymentAccountID>
		</paymentAccount>
	</payment>
</handlePaymentStateChangedNotificationRequest>

Astropay Bank Transfer Withdrawal

Redirect Integration

Backend2BackendIntegration

Data Validation

📘
Account Type for Brazil

📘
AccountType for other countries

📘
Identification Number Validation

Requests/Responses

Notifications

Testing instructions

BankTransferWithdrawalReturn

Redirect Integration

Backend2BackendIntegration

Data Validation

📘Account Type for Brazil

📘AccountType for other countries

📘Identification Number Validation

Requests/Responses

Notifications

Testing instructions

BankTransferWithdrawalReturn

📘
Account Type for Brazil

📘
AccountType for other countries

📘
Identification Number Validation