Create Transfer | B2C - Gcashier Pay

{
  "merOrderNo": "335621309488902",
  "infoObject": {
    "feeDirection": "OUR",
    "tradeComments": "Employee salary",
    "callbackUrl": "https://yourplatform.com/callback/transfer"
  },
  "senderObject": {
    "bizMode": "B",
    "bankCountry": "CN",
    "registerCountry": "CN",
    "companyName": "Acme Trading Co Ltd",
    "companyRegisterNo": "91110000123456789X",
    "companyIssueDate": "2015-03-01",
    "companyExpiryDate": "2035-03-01",
    "businessLicenseImg": "https://example.com/license.jpg",
    "addressCountry": "CN",
    "addressProvince": "110000",
    "addressCity": "Beijing",
    "addressLine": "No.88 Business Avenue"
  },
  "receiverObject": {
    "bizMode": "C",
    "payoutMethod": "WIRE",
    "accountNo": "123456789",
    "bankName": "BANK OF AMERICA",
    "swiftCode": "BOFAUS3N",
    "idType": "02",
    "idNumber": "A12345678",
    "frontCertImg": "https://example.com/passport.jpg",
    "backCertImg": "",
    "firstName": "John",
    "lastName": "Smith",
    "birthDate": "1985-05-15",
    "placeOfBirth": "US",
    "nationality": "US",
    "gender": "M",
    "addressCountry": "US",
    "addressProvince": "California",
    "addressCity": "Los Angeles",
    "addressLine": "123 Main St"
  },
  "complianceObject": {
    "fundSource": "01",
    "purpose": "44"
  }
}

{
  "merOrderNo": "335621309488902",
  "senderAmount": {
    "currency": "CNY",
    "amount": "35625.00"
  },
  "receiverAmount": {
    "currency": "USD",
    "amount": "5000.00",
    "bankCountry": "US"
  },
  "infoObject": {
    "bizFlow": "21875022415083500101",
    "senderId": "c3d4e5f6a1b2",
    "receiverId": "b2a1f6e5d4c3",
    "settlementNetwork": "SWIFT",
    "rate": "7.1250",
    "status": "PROCESS",
    "code": "S00001",
    "message": "Processing"
  }
}

B2C (Business-to-Consumer): sender (senderObject.bizMode = B) is an enterprise; receiver (receiverObject.bizMode = C) is an individual. English names and addresses must match the regex: ^[a-zA-Z0-9\s.,!?:;'"()\[\]{}/*\\-]+$

POST https://{baseUrl}/api/sp1307

Request Parameters

string

required

Your unique merchant order number. Must be consistent with the value used in sp1306. Max 32 characters.

object

required

Transfer settings and callback configuration.

Show infoObject fields

string

required

Fee arrangement. Required when settlementNetwork is SWIFT.

OUR — sender bears all fees.
SHA — each party bears their own bank fees.
BEN — receiver bears all fees.

string

Optional transfer remarks. Max 255 characters.

string

required

Your HTTPS callback URL to receive the sp3302 webhook with the final transfer result. Max 255 characters.

object

required

Enterprise sender’s company and address information.

Show senderObject fields

string

Pre-registered sender ID. If provided, skip all company fields below.

string

required

Business mode. Must be B for enterprise.

string

required

ISO 3166-1 alpha-2 country code of the sender’s bank. Also used as the source-of-funds country.

string

required

Country where the company is registered.

string

required

Company name. Allowed characters: ^[a-zA-Z0-9\s.,!?:;'"()\[\]{}/*\\-]+$

string

required

Company registration certificate number.

string

required

Certificate issue date. Format: YYYY-MM-DD.

string

required

Certificate expiry date. Format: YYYY-MM-DD.

string

Business license image. Required when bankCountry is CN.

string

Business registration certificate image. Required when bankCountry is HK.

string

Certificate of incorporation image. Required when bankCountry is non-CN. Also required when bankCountry is HK.

string

Company email address (optional).

string

Phone area code (optional). Must be provided together with phoneNo or both must be empty. See the phone code dictionary.

string

Phone number (optional). Must be provided together with phoneAreaCode or both must be empty.

string

required

businessNature.

string

required

Country of business address. See the country dictionary.

string

required

State or province. Use the English name for non-CN countries. Use the province/city code for CN. See the dictionary.

string

required

City.

string

required

Street address. Allowed characters: ^[a-zA-Z0-9\s.,!?:;'"()\[\]{}/*\\-]+$

string

required

Postal code.

object

required

Individual receiver’s bank account and identity information.

Show receiverObject fields

string

Pre-registered receiver ID. If provided, skip all individual fields below.

string

required

Payment method. For SWIFT, the default is WIRE. For LOCAL, see the payment method data dictionary.

string

required

Business mode. Must be C for individual.

string

required

Bank account number.

string

Bank code. Rules:

For LOCAL: required when payoutMethod is not WECHAT or ALIPAY. Also required when bankCountry is CN, BR, or IN (in which case branchCode is also required).
For SWIFT: not required (use bankName instead).

string

Bank name.

string

Branch code.

string

Correspondent bank name. Optional, SWIFT only. Either provide all three proxy bank fields or none.

string

Correspondent bank address. Optional, SWIFT only.

string

Correspondent bank SWIFT code. Optional, SWIFT only.

string

SWIFT/BIC code of the receiver’s bank. Required when settlementNetwork is SWIFT.

string

required

ID document type. 01 = National ID card, 02 = Passport.

string

required

ID document number.

string

National emblem side of the ID card, or passport photo page.

string

Portrait side of the ID card. Required when idType is 01.

string

required

English first name.

string

required

English last name.

string

required

Date of birth. Format: YYYY-MM-DD.

string

required

Place of birth. See the country dictionary.

string

required

Nationality. See the country dictionary.

string

required

Gender. M = Male, F = Female, X = Other.

string

Email address (optional).

string

Phone area code. Required when bankCountry is BR, KR, MA, or IN. See the phone code dictionary.

string

Phone number (optional).

string

required

Country of residence. See the country dictionary.

string

required

State or province. Use the English name for non-CN countries. Use the province/city code for CN. See the dictionary.

string

required

City.

string

required

Street address. Allowed characters: ^[a-zA-Z0-9\s.,!?:;'"()\[\]{}/*\\-]+$

string

Postal code (optional).

object

required

Compliance and purpose information.

Show complianceObject fields

string

required

Source of funds for the sender (enterprise). Use 01 (company funds).

string

required

Transfer purpose code. See the purpose data dictionary.

string

Relationship between sender and receiver (optional).

array

Supporting transaction documents (optional). Maximum 5 items.

Response Body

string

Echo of your merchant order number.

object

Sender amount and currency information.

Show senderAmount fields

string

Sender’s currency code (ISO 4217).

string

Sender’s amount. Two decimal places, format: 999999.99.

object

Receiver amount, currency, and bank country information.

Show receiverAmount fields

string

Receiver’s currency code (ISO 4217).

string

Receiver’s amount. Two decimal places, format: 999999.99.

string

ISO 3166-1 alpha-2 country code of the receiver’s bank.

object

Transfer status and reference information.

Show infoObject fields

string

System business flow number. Consistent with the value returned by sp1306. Retain this for reconciliation.

string

Sender’s registered ID. Present once the transfer is successfully confirmed.

string

Receiver’s registered ID. Present once the transfer is successfully confirmed.

string

Settlement network used: LOCAL or SWIFT.

string

Exchange rate applied to this transfer.

string

Current order status. Initial value is PROCESS (processing). The final result (SUCC or FAIL) is delivered asynchronously via the sp3302 webhook.

string

Transaction response code.

string

Transaction response message.

{
  "merOrderNo": "335621309488902",
  "infoObject": {
    "feeDirection": "OUR",
    "tradeComments": "Employee salary",
    "callbackUrl": "https://yourplatform.com/callback/transfer"
  },
  "senderObject": {
    "bizMode": "B",
    "bankCountry": "CN",
    "registerCountry": "CN",
    "companyName": "Acme Trading Co Ltd",
    "companyRegisterNo": "91110000123456789X",
    "companyIssueDate": "2015-03-01",
    "companyExpiryDate": "2035-03-01",
    "businessLicenseImg": "https://example.com/license.jpg",
    "addressCountry": "CN",
    "addressProvince": "110000",
    "addressCity": "Beijing",
    "addressLine": "No.88 Business Avenue"
  },
  "receiverObject": {
    "bizMode": "C",
    "payoutMethod": "WIRE",
    "accountNo": "123456789",
    "bankName": "BANK OF AMERICA",
    "swiftCode": "BOFAUS3N",
    "idType": "02",
    "idNumber": "A12345678",
    "frontCertImg": "https://example.com/passport.jpg",
    "backCertImg": "",
    "firstName": "John",
    "lastName": "Smith",
    "birthDate": "1985-05-15",
    "placeOfBirth": "US",
    "nationality": "US",
    "gender": "M",
    "addressCountry": "US",
    "addressProvince": "California",
    "addressCity": "Los Angeles",
    "addressLine": "123 Main St"
  },
  "complianceObject": {
    "fundSource": "01",
    "purpose": "44"
  }
}

{
  "merOrderNo": "335621309488902",
  "senderAmount": {
    "currency": "CNY",
    "amount": "35625.00"
  },
  "receiverAmount": {
    "currency": "USD",
    "amount": "5000.00",
    "bankCountry": "US"
  },
  "infoObject": {
    "bizFlow": "21875022415083500101",
    "senderId": "c3d4e5f6a1b2",
    "receiverId": "b2a1f6e5d4c3",
    "settlementNetwork": "SWIFT",
    "rate": "7.1250",
    "status": "PROCESS",
    "code": "S00001",
    "message": "Processing"
  }
}

Sandbox Testing

In the sandbox environment, the final transfer result is determined by the last digit of the submitted amount:

Last digit	Simulated result
0 – 3	Success (`SUCC`)
4 – 6	Rejected (`FAIL`)
7 – 9	No action (remains in `PROCESS`)

FileUpload

Transfer API

Market Specifics - Local Rails

Webhook Events

Beneficiary

Accounting

Meta Data API

Reference

Create Transfer | B2C

Request Parameters

Response Body

Sandbox Testing

​Request Parameters

​Response Body

​Sandbox Testing

Request Parameters

Response Body

Sandbox Testing